Issue82 June2019 | magpi.cc 


BUILD A 
PI KEYRING 


Keep your computer with 
you at all times 


Recreating a 
Space robot 


PLUS! 


Build a MIDI 
sequencer 


Model railway MAKE JN 


projects MARAUDER’S MAP 
Add NeoPixel Use beacons to locate people 
lighting to a display 


THE BEST AI LEARNING RESOURCES anu 


magpl.cc/store 


Canakit cH 


CanaKit Raspberry Pi 3 Ultimate Starter Kit 
Model B | 1 GB RAM | 1.2 GHz | Quad-Core CPU 


> Learn to Code 
> Explore Computing 
> Get started with Electronics 


KiT INCLUDES RASPBERRY P13 AND... 


2.5A 
POWER ADAPTER 


32 GB CLASs 10 
MicroSD CARD 


USB MicroSD 
CARD READER 


PREMIUM 
HDMI CABLE 


PREMIUM CASE & QUICK-START GUIDE 


HEAT SINKS 


PRE-LOADED 


ft 

i 

t 

l 

|S i 
a ; ~ ( 
A 1 

t 

i 

[ 

i 

’ WITH OPERATING SYSTEM 


RESISTORS & 
PUSH-BUTTONS 


FULL-SIZE 
BREADBOARD 


GPIO To BREADBOARD 


JUMPERS 
INTERFACE BOARD 


MALE TO MALE & 
MALE TO FEMALE 


Available for worldwide shipping at: 


WWW.CANAKIT.COM 
Raspberry Pi Zero W 


Now available at CanaKit! 


€} Bluetooth’ 


ELECTRONIC KITS e ELECTRONIC PARTS e RASPBERRY PI ¢ ARDUINO 


WELCOME 
to The MagP1 82 


oding is a life-changing skill. One of my first memories is 
creating a platform game at school; even though I loved coding, 
I went on to study English and take up a career in journalism. 

That was before Raspberry Pi and online training came along. A series 
of courses in Computational Thinking and Computer Science enabled 
me to pick up where I left off as a child. Coding had changed, but so 
had I: Scratch made it easy to visualise programs, and Python replaced 
BASIC. A greater focus on making fired my imagination. Computer 
science and coding also led me to Raspberry Pi, where I ended up 
editing this fine magazine. 

The Raspberry Pi was created to increase the number of students 
learning code and computer science. Needless to say, it was a roaring 
success. Almost a year since winning the prestigious MacRobert award, 
Raspberry Pi now finds itself stamped into history by the Royal Mail, 
which is celebrating 50 years of British engineering. It joins the likes of 
the Harrier Jump Jet in a special set of postage stamps (page 6). 

With the Pi’s prestigious prizes and Cambridge University history, 
you might be forgiven for thinking 
that coding isn’t for you — it’s for =e 10 AMAZING JAM HATS 
engineers and students, and you’ve The 
missed the coding boat. Nothing is 
further from the truth. Our feature 
(page 26) will get you started. 
Anybody can learn to code; everybody 
should learn to code. 
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Lucy 
Hattersley 


Editor of The MagPi. 
Lucy codes, crafts, 
and creates wonky 
robots. She speaks 
French (badly) and 
mangles the piano. 
One day shell get 
that pet dog. 
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DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 
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Raspberry P1 becomes 


first-class stamp 


Royal Mail ‘50 Years of Engineering’ series recognises role of ground-breaking 
mini computer, Rosie Hattersley reports on this prestigious recognition 


> Raspberry Pi can 
now be found ona 
first-class stamp 


< fm vy v. i [~ 


British Engineering 


We’ ve been convinced of its brilliance 
ever since the idea of an ultra-affordable, 
incredibly adaptable, and very tiny computer 
for coding was first mooted. Now, our beloved 
Raspberry Pi has been honoured by appearing on 
one of six Royal Mail stamp designs celebrating 
50 years of British engineering. 

Liz Upton, Raspberry Pi’s Executive Director 
of Communications, announced the incredible 
news that from 2 May, Raspberry Pi fans would 
be able to get their hands on a brand-new Pi 


T he Raspberry Pi is a marvellous idea. 


A The stamp series celebrates 50 years of British engineering 


collectable — a special-edition stamp. Liz said, 
“We’re absolutely made up to be one of the 
engineering projects chosen: we’re in some 
exalted company.” 

The Raspberry Pi stamp joins the Harrier 
Jump Jet, catalytic converter, Falkirk 
: Wheel, synthetic bone-graft substitute, and 
Superconducting magnets as world-class 
examples of British engineering. 

Special first-day cover commemorative 
presentation packs, containing all six 


PrLOrt “Sf N/ 


) sated uter ° engineering-focused stamps, can be 

2 Raspberry Pi microcomp ¢ bought for £13 from the Royal Mail website 
¢ helps to teach programming S (magpi.cc/zVBgUX) and at some Post Office 
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| Royal Mail Stamps 


Raspberry Pi microcomputer The Falkirk Wheel rotating boat Three-way catalytic converter 
helps to teach programming lift connects Scottish waterways reduces pollutants in car exhaust | of new rail tunnels under London 


Superconducting magnet allows Synthetic bone-graft material 
high-quality imaging in MRI encourages new bone growth 


M The honour of appearing on ag stamp comes 
two years after the Raspberry Pi won the Royal 
Academy of Engineering MacRobert Award 
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of the Harrier Jump Jet. The honour of appearing 
on a stamp comes two years after the Raspberry 
Pi won the Royal Academy of Engineering 


Stamp designs © MacRobert Award (magpi.cc/LZNeDT). The 


Royal Mail Group Ltd. prize recognised the Pi’s role in reversing the 

Reproduced by kind downward trend in interest in computer science 

permission of Royal : 

Mail Group Lid. and programming. The stamps also honour 50 Superconducting magnet allows Synthetic bone-graft material 
All rights reserved. years of the MacRobert Award’s existence. Hl Bea re be ty TE Sn mel omg ed tern Bae 
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4 Packed with data- 
gathering sensors, the 
board contains a secure 
chip for connecting 

to Google Cloud loT 
Core for analysing 

the information 


Coral Environmental 
Sensor Board 


Google launches new board for Pi with sensors and Google Cloud integration. 


By Lucy Hattersley 


oogle has released a new Raspberry Pi 
product under its Coral brand (previously 
AIY Projects). The Environmental Sensor 
Board adds a range of sensors and a 128*32 OLED 
display to the Pi. 

More importantly, the board is designed to 
connect securely to Google’s Cloud IoT Core 
service (cloud.google.com/iot-core), enabling 
you to securely transmit data and perform detailed 
analysis on it (with Google’s range of ML tools). 

The Environmental Sensor Board connects 
to Google IoT Cloud platform via a Microchip 
ECC608 crypto chip with Google keys. 

On the board, you’ll find a HDC2010 humidity 
sensor, OPT3002 ambient light sensor, and 
BMP280 barometric pressure sensor, along 
with UART, I?C, and PWM connections. A full 
datasheet can be found here: magpi.cc/uxHKEE. 

The new board also sports four Grove 
connectors (magpi.cc/eCbZbF), enabling you 
to quickly attach additional components for 
prototyping without needing to use jumper wires 
or a soldering iron. 
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Environmental Sensor Board 


Google has documentation for a couple of 
Python classes, both of which we’re looking at 
closely for potential The MagPi tutorials. The 
first is coral.enviro.board, described as “an 
interface for all input and output modules”; the 
second is coral.cloudiot.core, which “manages a 
connection to Google Cloud IoT Core via MQTT, 
using aJWT for device authentication.” Both can 
be found at coral.withgoogle.com/docs. 

The Environmental Sensor Board costs £20.62 
/S24.95, and is available now from Mouser.com 
(magpi.cc/fnebgR). Hl 


A The Environmental 
Sensor Board packs 
four Grove connectors 
that make prototyping 
faster and easier 
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Yuri 3 Mars rover 


John 
Chinner 


John is an engineer 
and STEM 
ambassador at 
Airbus UK. He 
worked on the 
Astro Pi project, 
testing the 
Raspberry Pi units 
sent into space. 


magpi.cc/OOmaUK 


Yuri 3 sitting 
alongside 
Featherstone and 
Rocky Rover at the 
Pi Wars 2019 event 
Credit: Harry Brenton 
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In Mission Mode, 
Yuri can be set 

to live-stream its 
journey across 
Mars's terrain while 
young scientists 
control it remotely 


Airbus engineer John Chinner unvells the secrets 
behind his Pi-powered Yur! 3 Mars rover to a 


delighted Rosie Hattersley 


Apollo moon landing, this year’s Pi Wars 
was space-themed. Visitors to the two-day 
event — held at Cambridge University at the end of 
March — were lucky enough to witness a number 
of competitors and demonstration space-themed 

robots in action. 

Among the most impressive was the Yuri 3 mini 
Mars rover which was designed, lovingly crafted, 
and operated by Airbus engineer John Chinner. 
Fascinated by its accuracy, we got John to give us 
the inside scoop. 


n honour of the 50th anniversary of the 


Airbus ambassador 

John is on the STEM ambassador team at Airbus 
and has previously demonstrated its prototype 
ExoMars rover, Bridget (you can drool over images 
of this here: magpi.cc/btQnEw), including at the 
BBC Stargazing Live event in Leicester. Realising 
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A. John snuck Yuri 3 onto Airbus's Mars yard and gave 
ita test-run on a proper Mars test environment 


the impressive robot’s practical limitations in 

terms of taking it out and about to schools, John 

embarked on a smaller but highly faithful, easily ——s 
transportable Mars rover. His robot-building ial easel 
experience began in his teens with a six-legged | 
robot he took along to his technical engineering 
apprenticeship interview and had walk along the 
desk. Job deftly bagged, he’s been building robots 
ever since. 


M™ The part more challenging 
for home users Is the ‘gold 
thermal blanket’ @ 


Yuri is a combination of an Actobotics 
chassis based on one created by Beatty Robotics 
(beatty-robotics.com), 3D-printed wheels, and 
six 12 V DC brushed gears. Six Hitec servo motors 
operate the steering, while the entire rover has an 
original Raspberry Pi B+ at its heart. 
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Yuri 3's Actobotics chassis is 
based on one used in rovers 
built by Beatty Robotics fora 
science museum 


John designed, built, and 
3D-printed the individually 
controllable wheels from 
scratch, while a Raspberry 
Pi B+ acts as Yuri 3's brain 


Quick FACTS 


Prior to building 
Yuri 3, John was a 
Python novice 

~ Sap eeets- 
ere > Most of the 
= — development work 
a a took place on his 
mother-in-law's 
dining table! 


* 


> John was 
responsible for the 
shock, vibration, 
and EMC testing on 
the Astro Pi units 


Yuri 3 usually runs in ‘tank steer’ mode. Cannily, 
the positioning of four of its six wheels at the 
corners means Yuri 3’s wheels can each be turned 
so it spins on the spot. It can also ‘crab’ to the side 
due to its individually steerable wheels. 

The part more challenging for home users is the 
‘gold thermal blanket’. The blanket ensures that 
the rover can maintain working temperature in 
the extreme conditions found on Mars. “I was very 
fortunate to have a bespoke blanket made by the 
team who make them for satellites,” says 
John. “They used it as a training exercise for 


> Jim Henson's 
animatronic 
puppets were his 
original inspiration 


> The gold blanket 
protects the 
rover in extreme 
conditions (as 


; is A Yuri 3 being tested on a beach to recreate challenging 
the apprentices. terrain navigation found on Mars) 
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Building a Mars rover 


‘a! - 
. * 


01 Yuri 3's chassis is based on a Beatty Robotics 
one, but the rover was designed and built by 
John. Some parts come from Actobotics, while the 
steering motors are standard RC-style servos. The 
gold blanket was bespoke-made for accuracy (but 
isn't required to function on Earth). 


02 Yuri 3 has six separate servo motors, all 

controlled with Python. John operates the 
robot using a combination of Nintendo Wii Remote 
and Nunchuk controllers to manoeuvre the chassis 
and head respectively. 


In ‘mission mode’ you get a rover-centric live- 
streamed view. Yuri follows commands entered 
by students in a classroom using the menu-driven 
Python script. Meanwhile, an audience watching in the 
school hall witnesses them attempt to avoid obstacles 
and seek a hidden alien. 
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A Yuri 3 explores the 
Martian landscape... 
only kidding - it's the 
local beach 


> With its six 
individually steerable 
wheels and rugged 
chassis, Yuri 3 can 
handle rough terrain 


John has made some bookmarks from the 
leftover thermal material which he gives away to 
schools to use as prizes. 


Rover design 
While designing Yuri 3, it probably helped that 
John was able to sneak peeks of Airbus’s ExoMars 
prototypes being tested at the firm’s Mars Yard. 
(He once snuck Yuri 3 onto the yard and gave it a 
test run, but that’s supposed to be a secret!) Also, 
says John, “I get to see the actual flight rover in its 
interplanetary bio clean room”. 

His involvement with all things Raspberry 
Pi came about when he was part of the Astro 
Pi project, in which students send code to two 
Raspberry Pi devices on board the International 
Space Station. “I did the shock, vibration, and 
EMC testing on the actual Astro Pi units in Airbus, 
Portsmouth,” John proudly tells us. 
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V John’s daughter, and budding space-flight engineer inspects 
an earlier version of Yuri 3 - note the original red wheels 


mM What a fantastic 


Sample of 


opportunity for a |e I | 


Rover Yuri 3 


exciting outreach @ 


A very British rover 
As part of the European Space Agency mission, 
ExoMars, Airbus is building and integrating the 
rover in Stevenage. “What a fantastic opportunity 
for exciting outreach,” says John. “After all the fun 
with Tim Peake’s Principia mission, why not make 
the next British astronaut a Mars rover? ... It is 
exciting to be able to go and visit Stevenage and see 
the prototype rovers testing on the Mars Yard.” 
John also mentions that he’d love to see Yuri 3 
put in an appearance at the Raspberry Pi store; in 
the meantime, drooling punters will have to build 
their own Mars rover from similar kit. Or, we’1l . 
just enjoy John’s footage of Yuri 3 in action and | 2 ——_—-- | 
perhaps ask very nicely if he’ll bring Yuri along for | “Don't let anybody tell you you cant do anything” 
a demonstration at an event or school near us. Tim Peake 
John blogged the first year of his experience 
building Yuri 3 on his blog (magpi.cc/oomaUK). 
And vee tollow the a of Yuri 3 over on A The gold blanket is used to keep the Mars rover safe in extreme temperatures. 


Twitter (@Yuri_3_Rover). 


Mf Leftovers have been used to create bookmarks as rewards for students 
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Telepresence Hand 
Hazardous Areas 


Manipulate objects at a distance without using space wizard powers, thanks 
to this remote-controlled robo-arm. Rob Zwetsloot tries it on for size 


leleonme4qence Hane lor Koga chow Fureeas. 


T here’s a scene at the start of eighties classic 


Short Circuit where Steve Guttenberg is Bloch Dragrae 
hiding away in a lab, programming a robot 
Andrew hand that is playing the piano. It’s quite quaint by 
Loeliger today’s robotic standards (and was probably just a Glove ms Contre Rabot Hand 
; a [ uco | 
puppet at the time), which is only more apparent ; : 
POUR Vear hen viewing Andrew Loeliger’s university proj : Base Servo 
student at the VS IMI cree eueee a eaver ey ErOleC Feather Station Board | 
University of from the last year. = 
Strathclyde “T set out to provide a solution to the issue 
studying Electronic of first line responders operating in dangerous A Here's the breakdown of how the system works 
and Electrical Aad ia: Cent ier 
ERGINEC ana areas, " Andrew explains. “Bomb disposal sites, 
biohazardous areas, and nuclear hot zones are all The user wears a glove that’s connected to a 
crucial areas where human intervention would be ‘base Station’, which also has a display. The display 
required but could be potentially life-threatening. shows the pictures from a wirelessly connected 
The aim of the project was to develop an extremely camera, which is part of the remote robot hand 
low-cost robotic hand that can operate in hazardous system. The glove has a series of sensors to record 
areas and perform dextrous tasks while being how the fingers and hand are moved, and that is 
V There's currently no controlled and viewed remotely. The visual feedback then relayed to the hand controller. 
nov es provided by the system allows the user to control 
the glove, but this ; . 
can be easily added every movement of the hand as if they were there.” Hand print 


“The bulk of the robot hand comprises 3D-printed 
components,” Andrew tells us. “The design files 
for the 3D-printed components were sourced from 
InMoov. The 3D-printed robot hand is designed 

to hold all of the servos needed to mimic user 
movements made in the glove remotely. To control 
the robot hand, there is the Raspberry Pi Zero W 
which takes the received values from the base 
station and sends them to the servo driver board to 
move the servos. There is one servo for each finger 
and each finger is moved via a braided fishing line 
pulley system within the finger.” 


Robotic mimicry 

The hand works very well, according to Andrew: 
“The project worked as hoped and is simple to 
use, as the user simply needs to put the glove 
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This 3D-printed robot arm 
perfectly captures the 
movement of the user 


. 


The glove contains 
multiple flex sensors to 
figure out how you're 
using your fingers 


: 
| 


| 


™ The user simply needs to 
put the glove on and move 
their hand to make the 
robot hand work @ 


on and move their hand to make the robot hand 
work. One of the really nice features is that there 
is low latency between the glove and robot hand 
movements, which means the hand truly mimics 
the user’s finger movements.” 

Andrew has plans to improve the design with 
a new version that makes use of Bluetooth Low 
Energy for the glow, along with sensors so the 
hand can turn at the wrist, and perhaps a haptic 
feedback system as well. 

There is one final use case that Andrew has 
found: “Although I originally considered this 
project for hazardous areas, interest has been 
shown in it from a prosthetics point of view.” Hl 


The base station 
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Quick FACTS 


‘A My 


> The idea is inspired 
by giant robot flick 
Pacific Rim, albeit 
much smaller 


f \" 
a\ 
ae \ 


NV 


Vv 


Andrew designed 
a custom PCB for 
the project 


It should be more 
effective than 
preprogrammed 
automatons 


Vv 


connects it all together, 


giving a video view of 


The Pi's size and 


Vv 


the remote hand as well power make 


A Aseries of servos controls the 
individual digits on the robot hand 


it perfect for 
this project 


The wrist-turning 
servo Is actually 
already in place 
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The OpenSprinkler Pi HAT allows 


makes use of a Raspberry Pi's 


GPIO pins to directly access and 


control sprinkler valves 


The OpenSprinkler Pi 
software needs to be 
installed on the Raspberry Pi 


By integrating the 
Raspberry Pi into the 
sprinkler setup, it can be 
reachable from the internet 


Curiosity killed the cat, but water deterred them from pooping 
in Davide Magni's garden, as David Crookes explains 


Davide is a 
telecommunications 
engineer who is 
addicted to art and 
design. He has been 
a programmer for 
15 years. 


tidal. it 
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he internet loves cats and they are indeed 

very cute. But when they’re ‘feline’ in the 

mood for pooping, there’s a good chance 
one will paw-se for a short spell in your garden and 
leave you to clear up the mess. 

That happened to Davide Magni’s cousin, who 
moved into the house next door to him in Italy. 
“She spent more than a week cleaning her garden 
of cat-droppings,” he recalls. “All the cats in the 
area were using that small piece of land as their 
litter and I wondered how I could prevent it from 
happening in my own garden in the future.” 

As it happens, Davide was rearranging an 
irrigation system in his garden when he began to 
consider a solution. “I started to place sprinklers in 
key locations, looking for a way to equally wet the 
whole garden using trial-and-error and activating 


them manually,” he says, before realising they 
could serve a dual cat-chasing purpose. 


Sprinkle of Pi 

The first important thing was automating the 
system so that it could be used when Davide was 
away from home or if he forgot to activate it. “I 
decided to use a Raspberry Pi because I wanted 
something that would provide APIs and integrate 
with other Internet of Things devices I have at 
home,” Davide tells us. “I certainly didn’t want 
a closed, self-contained system that wouldn’t 
interact with other devices.” 

Luckily, there is an open platform which 
allows irrigation systems to be controlled: called 
OpenSprinkler, it supports the Pi, has its own 
extension board, and is connected to the web for 


remote access. “It provides everything I need for 
good irrigation control such as daily programming, 
a web GUI, and weather-based prediction,” Davide 
continues. With that in place, it was time to turn 
his attention to those troublesome cats. 


™ My cousin spent more 
than dg week cleaning her 
garden of cat-droppings @ 


Pi spy cats 

Davide’s wife had bought him a Netatmo 
Presence outdoor smart camera as a Christmas 
eift. It detects movement, shines a bright light, 
and records what it sees; it can also distinguish 
between people, animals, and vehicles. As such, it 
was the perfect input device. 

Initially, he pushed the Netatmo trigger through 
IFTTT to send a notification that activated the 
sprinklers, but it took so long that the cats would 
have done their business and already left. To 
improve performance, he created an ad-hoc 
application with Netatmo Connect which receives 
the camera trigger and sends it to a self-hosted site 


that runs a small script. This decides if the shower 
needs activating and sends it to OpenSprinkler. 

“T added a callback, a simple PHP script call, 
that is invoked directly from the camera every 
time it detects a movement,” says Davide. “The 
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<4 Andiit's off: the 
camera catches 
the momenta cat 
is squirted with 
water. It's soon 
over the gate 


> OpenSprinkler 
Pi ($75) is at the 
project's heart 


> It makes use 
of an extensive 
sprinkler system 


> Cats are detected 
by asmart camera 


> Sprinklers are 
activated to chase 
them away 


> No cats are harmed 
by the water 


a 


; a : ) 


A The garden 
excavation for the 
laying of the water 
pipes and the electric 
cables to control the 
opening of the valves 
was the toughest 
part of the project 


script verifies that the call is valid, checks the 
system status, sends the activation signal to 


OpenSprinkler, and logs the event.” 


Now, when a cat strays into the garden, the 
sprinklers kick in within seconds and chase them 
away, but there are some pitfalls. “For future 
developments, I’m thinking about being able to 
keep a small history of events in order to avoid 
activating a shower if a person and an animal 
approaches — such as my mum passing with her 


dog,” he laughs. Hl 
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DIY Hardware 
Password Keeper 


Do you use Password12s for all of your online services? David Crookes looks at 
qg P| Zero-based device that should help you come up with more secure logins 


xperts suggest that we should use a With this in mind, Eugene got to work. He 
different password for every online service — wanted to create a device that couldn’t be hacked 
we access, but, as many users know, trying remotely over anetwork. What’s more, he didn’t 


to remember them all can be rather difficult. want users to have to type in a password to unlock 
Better, then, to have a secure and convenient the device and he wanted it to be relatively small, 

system that can store and recall them for you, with secure and encrypted storage. 

which is why Eugene Dzhurynsky has created 

a hardware password storage device based Securing the system 
Eugene . ; « 
Dzhurynsky around a Raspberry Pi Zero and radio frequency Encryption, he says, was the easy ee I could use 

identification (RFID) technology. any industry standard encryption,” he explains. 
Eugene is a Inspired by a thread on Reddit which explained The tricky aspect was the key — the component 
Ukrainian software how the Pi Zero could function as a USB device, that would unlock the encrypted file containing a 
engineer living Eugene noted that the Pi Zero could control user’s passwords. 
eee another computer and act as a keyboard. “It Eugene intended to store the passwords on the 
and he is currently was a ‘wow’ moment and I was stunned by the Pi Zero, so he figured that placing a private key on 
working as a possibilities,” he recalls. an RFID fob would work well. With the Pi-based 


data engineer 
and machine- 
learning specialist. 
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gP y The user presses the buttons to F. 


ad 
the right of the screen, letting 
them navigate and selecta 
password they want to use 


As long as the password-input field on a web When this rightmost button 
form or application is expecting an input, the is clicked, the Pi Zero sends 
password will be inserted in the same way as the password down a USB 
if the user were typing it themselves cable to the computer 
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A When activated, the screen shows accounts that have stored 
passwords and allows them to be used on a linked computer 


device wired to an RFID card reader and connected 
to acomputer, he reckoned a user would only need 
to bring the fob close to unlock the device and 
allow the passwords to be accessed and shared. 

A user could then log in to whatever service they 
were trying to access. 

Certainly, the Pi Zero proved the perfect fit. “It 
has a Linux OS, it’s easy to manage, it’s developer 
friendly, and it has enough memory and network 
adapters,” Eugene says. He coded it using the 
programming language Go (golang.org) and he 
fitted the device with a small OLED SPI display 
before allowing it to be controlled via some 
buttons positioned on the front. All were placed 
in a self-made case. 


M | don't use It to keep my 
own passwords - it's just 
gq pet project @ 


Playing it safe 
In order to add and manage the passwords, 
Eugene then made use of a web interface which 
was put together with the help of friend Maxim 
Vassilyev. “Pi Zero can present itself as network 
interface as well as a keyboard so by navigating 
to the local address http://10.101.1.1, the web 
interface for the password management will be 
accessible,” Eugene explains. 

He says it only works in the presence of the 
fob: “So if someone will try to plug the Pi into a 


PROJECT SHOWCASE | Magri 


ae 
-_—— ; 
ws —— : 
‘a 1 mn 
r; ; a ; 
' > — - 
a > F ~ ~ 
7 ; ; 
- . 47) 
i SITES ; 
y ie ge . ; 
- 3 
& Pa > 7 tri ; 
* I. - f — 
J : : - 


A The RFID RC522 sensor is inexpensive and allows this system 
to become unlockable only when an RFID key fob is presented 


computer, they won’t be able to access passwords.” 
And yet the system is not quite perfect. “The key 
can be compromised if it’s used with some cheap 
RFID cards,” Eugene admits. “But if you just keep 
the key in an RFID-protective cover, then it’s going 
to be safe.” 

So could it be used as a professional tool in its 
current state? “Tough question,” replies Eugene. 

“T don’t use it to keep my own passwords, that’s 
the answer. But it’s just a pet project and there are 
many things to be added before it will become truly 
safe and secure.” 

Indeed, he wants to add backup and restore 
options for the internal storage and RFID key, and 
he wishes to improve the web interface, add a help 
section, provide an easy way to add more keys and 
users, have the device generate passwords, and 
add a real-time clock for random seed generation. 
“People seem to like the approach I’ve been 
taking,” he says. H] 


Quick FACTS 


> The device 
stores encrypted 
passwords 


> The software was 
built using the 
language Go 


> It makes use of an 
RFID key fob 


> Passwords are 
added viaa 
web interface 


> Eugene wants 
to add voice 
recognition 
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Pi VizuWall 


This Raspberry Pi cluster has moving parts and a serious 
goal to help train programmers, Phil King finds out more 


ounted on a clear acrylic plate, twelve mainframe computer. Perhaps the solution to the 
Raspberry Pi boards suddenly spring so-called Ninja Gap?” 
into life, moving outwards, as if waving Matt is referring to the difficulty of enabling 
to the attendees at Maker Faire Miami. Not just computer science students to obtain enough early 
a cool effect, the movement is proportional to experience programming parallel computing 
each Pi’s level of activity in a parallel computing systems to become industry-proficient. Hence his 
cluster. This is Pi VizuWall, a project created by motivation for building a low-cost cluster system 
Matt long-time computer engineer Matt Trask during with Raspberry Pi boards, in order to drive down 
Trask his degree course at Florida Atlantic University the entry-level costs. 
(FAU), while doing research into a new class of 
Matt is a Researcher supercomputer systems. Moving parts 
and Chief Engineer “When I am successful (heh, nearly said ‘if? Matt reveals how Pi VizuWall works: “Each node is 
at the FAU Machine ‘ : ; ‘ 
Perecolionand there...), it will obsolete MPI [Message Passing capable of moving through about 90 degrees under 
Cognitive Robotics Interface] as the main means of programming software control because a small electric servo 
Lab and is grateful distributed compute clusters,” explains Matt. motor is embedded in the hinging mechanism. The 
- is pier im “This means that my variant of the Beowulf acrylic parts are laser-cut, and the hinge parts have 
Recearch and architecture will function as a distributed been 3D-printed for this prototype.” 
Inquiry for its symmetric multiprocessing system that appears While the original concept was to also use LEDs 
ade coe to be a single unified system that is the sum of to edge-light the acrylic plate and change the 
. all RAM and all cores in the cluster: a virtual colours to indicate CPU usage, Matt says the idea 
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A cluster of twelve Pi 
3B nodes communicate 
via wired Ethernet 
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Each Pi is mounted on a hinged 
acrylic panel, capable of 
moving out up to 90 degrees 
under software control 


Micro servos are embedded in 

3D-printed housings, but the 

latter will be replaced by CNCed ——, 
aluminium ones in the next version 


= 
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™ The physical motion helps 
Student programmers 
Understand their 
system utilisation 


of the moving boards was always fundamental to 
the project: “I figured that the physical motion 
would help student programmers understand their 
system utilisation. And it looks cool.” 

Although Matt came up with the project’s 
concept several years ago, he only started building 
it in late 2018. “I collaborated with Art Rozenbaum 
(FAU Mechanical Engineer) over the fall to develop 
the concept and submitted my research proposal in 
November,” he tells us. “Art and I worked through 
my original concept for mounting the servos 
behind the board and pivoted to his concept of 
embedding them in the hinge mechanism, a much 
cleaner solution.” 

Currently, the Raspberry Pi boards have wired 
communication via a 14-port Ethernet switch, 
but Matt is looking into making it wireless. This 
will involve “evaluating whether the Pi’s wireless 
LAN capability is suitable for carrying the MPI 
message traffic, given that the wired Ethernet has 
ereater bandwidth.” 


Scale model 

The original plan for Pi VizuWall was to create a 
4x8 ft (1.2x2.4m) wall with 300 Raspberry Pi boards 
wired as a Beowulf cluster running the MPICH 
implementation of MPI. “When I proposed this 
project to my Lab Directors at the university, they 
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40 Hinges and housings 
were 3D-printed, while 
the acrylic panels were 
laser-cut 


> This prototype 
was created to 
justify the cost of 
building a much 
larger version 


> PoE will be used 
to simply power 
distribution in the 
next iteration 


> Matt has beena 
computer engineer 
for nearly 40 years 


> He wrote the first 
virtual machine 
software on the 
80386 processor 
in 1986 


> He got his first 
Raspberry Pi 
in 2012 


A Ethernet cables 
are tucked neatly 
between each Pi and 
its hinged panel, so 
as not to impede 
its movement 


baulked at the estimated cost of S20-25,000 and 
suggested a scaled-down prototype first.” 

Matt says some lessons have been learnt in the 
process of building it, including plans to replace 
the 3D-printed plastic motor housings — which 
suffered minor distortion due to heat from the 
servos — with CNCed aluminium. “This will [also] 
permit us to have finer resolution when creating 
the splines that engage with the shaft of the servo 
motor, solving the problem of occasional slippage 
under load that we have seen with this version.” 

The ultimate goal is to “create a massive piece 
of kinetic art to embellish the entryway to our new 
Lab facility at the university.” 
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The Raspberr 
Pi Hologram 
Machine 


Wondering what to do with a spare 17-inch monitor, 
Dan Aldred teamed it with an old IKEA table and an 
acrylic pyramid. The results are truly hologramtastic, 
gs Nicola King discovers 


The four projected images 
combine into one, appearing 
as if inside the pyramid 


an, a secondary school teacher, was 

chatting one day with his students about 

a hologram hack that some of them had 
developed using a mobile phone and an old CD 
case, as he explains: “The phone lies flat ona 
surface of the screen and a small, we are talking 
probably around 5cm max, inverted pyramid sits 
on top of the screen. I asked one of the students 


Dan built the pyramid 
from laser-cut acrylic 


ee if you could flip the pyramid and still create the 

hologram. They said, yes, ifthe screenisatthetop four-sided pyramid. The Raspberry Pi A+ runs a 
Raspberry Pi rather than the bottom.” Python program on bootup, which plays videos 
enthusiast, NCCE So, armed with this snippet of inspiration, Dan from a folder. These are ‘hologram’ videos which 
ec ec decided to model his very own version: “I wanted contain the same image orientated in four different 
an a ene = to create a large standalone machine that would angles: front, back, left, and right. The acrylic 
projects and hacks display holograms and let the users select them reflects back the image from the overhead screen, 
to inspire others with buttons. I also knew that it would makea good creating the illusion that a single solid object 
as eee F centrepiece for open evenings!” is floating in the middle of the pyramid. As you 
Kinect 360, Python, view the pyramid from a different side, you see a 
and Pi working with Building a pyramid different perspective.” Dan has also added three 
Soe Onicr Simple in design, Dan’s idea developed quickly. buttons — coded with the GPIO Zero library — to 

His first issue concerned the dimensions of the pause a video, skip to the next hologram, and shut 

pyramid, which he made himself out of acrylic down the Raspberry Pi. 


using a laser cutter. “The main focus of the build 
was on the calculations for the pyramid, toensure 3D fun 


that it was the correct size for the screen,” says As with many projects, a little fine-tuning was 
Dan. “I had a spare screen which I wanted to required to ensure it all worked as Dan had 
reuse, rather than buying a new one. | also had an envisaged. For example, he had to be careful what 
old IKEA coffee table which I upcycled to hold the videos he used in the machine: “I had to search 
screen and house the pyramid. Basically, I cut the for inverted videos as the most popular videos are 
legs in half and used one half for the base legs, and _ designed for the phone version with the upside- 
the other for the monitor supports.” down pyramid. This means that, when playinga 
So, how does this machine work exactly? Dan video in my Hologram Machine, they were 
explains, “A screen is supported above a clear, upside down.” 
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Special videos are 
played on an upside- 
down monitor 


Quick FACTS 


> Dan's most 
popular hologram 
is the incredibly 
realistic lightning 


> Videos must 
be inverted to 
show correctly in 
the pyramid 


> The video player is 
based on code by 
Les Pounder 


> The sawn table 
legs were filled with 
expanding foam 


V_ The monitor is mounted on the sawn-off legs > Dan is working on 
of an IKEA table, its top used as a base 
a real-time night- 


M | wanted to create a large Geen cee 
Standalone machine that 
would display holograms @ 


One would guess that you could make the 
Hologram Machine any size, then, as long as your 
screen is big enough? “On posting the completed 
project on Twitter, one of the first responses 
was a retweet with the idea that I should use a 
projector as the screen and build a giant one-metre 
hologram! So yes, as long as the screen is big, you 
can increase the size of the pyramid and create a 
larger hologram,” reckons Dan. 

As to the future, he says that he would like to 
develop the Hologram Machine with an HDMI 
monitor, so as to improve hologram quality. “I 
am also looking at an alternative to the acrylic as 
it is difficult to keep clean!” he adds. “You only 
have to look at it and it gets dirty - perhaps a 
glass pyramid.” 
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SUBSCRIBE TODAY 
FROM ONLY £5 


UPTO SO /o 


» FREE Delivery 
Get it fast and for FREE 


» Exclusive Offers 
Great gifts, offers, and discounts 


» Great Savings 
Save up to 35% compared to stores 


Low Monthly Cost (from £5) 
» Cancel at any time 


» Free delivery to your door 
» Available worldwide 


£55 (UK) £90 (USA & Rest of World) 
£80 (EU) 


Free Pi Zero W Kit with 12 Month upfront subscription 


only (no Pi Zero Kit with Rolling Monthly Subscription) 


® Subscribe by phone: 01293 312193 
© Subscribe online: magpi.cc/subscribe 


Email: magpi@subscriptionhelpline.co.uk 
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Pi Zero W case 
with three covers 


USB and HDMI 
converter cables 


Camera Module 
connector 
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igPi | FEATURE 


LEARN TO 


WITH SCRATCH & 


Sahn © Filev Editv Lt Hx 


SM learn scratch game 


when clicked 


AUTHOR 


set score to J 


Hello! 
Hmm 


Hmm...@ 


by @ 


change ‘score 


wait ee secs 
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New Load Run Debug p28 START 
08 ony comes = CODING WITH 
import random SCR IGH 
questions = ["As you like it", "The Tempest", "Measure for Measure", sa cla 
"Much Ado About Nothing", “The Comedy of Errors", group_lengt 


"King Lear", "Cymbeline", "Hamlet", "Coriolanus", "Othello", 
“Love's Labour's Lost", "King John", “Julius Caesar", “Edward 


sen_phrase = random.choice(questions) uzzle 
en_phrase = chosen_phrase.upper() es eee 
<= p31 CODE A 
i a vol REN QUIZ, GA WIE 
in chosen_phrase: WITH Feat IO] | 
letter in vowels: 
Zle += letter 


+ cesar p34 MAKE AN 
ILE, D WONG Il 
q earning to code can be one of the most profound WATE aL Ie NA TTSIOUN 


skills you will ever develop. With code, you can 
control a computer. You can get it to do things for you, 


and also control gizmos and other computers. Kick back and 
let your computer do all the work. p35 BUILD AN 
Sure, that’s cool. But coding is about more than that. It’s ELECTRONIC 


about understanding how computers work, and getting a 
better understanding of how technology - and the modern GAME 
world — works. It’s about breaking down problems into little 
bits and solving them. It’s an amazingly helpful life skill. 
That’s why it’s profound. 
On a more practical level, knowing just a little code can 
lead to better job opportunities; a little more can open up 
well-paid and fun jobs. It’s an impressive skill to put on 
your CV and anybody can do it. Anybody. 
Coding is a lot easier than you think. And putting the 
power of computing and digital making into the hands of 
people is what Raspberry Pi is all about. 
The Raspberry Pi is ‘the little computer that could’, 
and you’re ‘the person who can’. Don’t worry: you’ve 
got this. We can help you get started. 


M The Raspberry Pi ts ‘the little 
computer that could', and you're 
‘the person who can’ 


Learn to code 
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tart coding 


Beginners, arise! It's time to take your first steps with 
coding, ds we introduce you to Scratch and Python, with 
g sprinkling of twinkling LEDs! By Sean McManus 


eing able to write programs is like a superpower: 


it Means you can get your computer to do 
whatever you want. Join us as we show you 
how to make your first programs using Scratch and 
Python. You’ll also see how easy it is to build simple 
electronics projects. 
A program is just a set of instructions. In Scratch, 
the instructions are written with visual blocks that 
lock together to make a sequence called a script. 
The blocks are colour-coded to help you find 
them. To find the brown blocks, for example, 
click the brown Events button above the 
Blocks Palette. 
Scratch makes coding easier, because you 
don’t need to worry about the spelling of 
commands. And everything is laid out in 
front of you. 


The Scratch screen is divided into units called 
steps. When the cat moves 10 steps, it only makes 
one movement, but that stride shifts it 10 positions 
across the Stage. The middle of the Stage is at 
x=0, y=0. The x-axis (left to right) runs from -240 
to +240, and the y-axis (bottom to top) runs from 
-180 to +180. The directions the sprite can move 
in are numbered 0 (up), 90 (right), 180 or -180 
(down), and -90 (left). You can use numbers in 
between those numbers too, so -45 would be a 


01 Start Scratch 2 
Open Scratch by clicking on the Raspberry Pi 
Menu icon and choosing Programming > Scratch 2. 
You will see Scratch interface and a single 
character in the top-left, known as ‘Scratch Cat’. 

To control the Scratch Cat, we’re going to drag 
blocks from the Blocks Palette into the Scripts Area 
and join them together. 

Start by clicking on Events and drag the 
when __ clicked block to the Scripts Area. 

Now click on Motion and drag a 
point in direction 90 block and connect it the to 
the bottom of the (when __ clicked) block. 

Click on the fields in the blocks to edit the 
numbers. Click on ‘90’ and change it to ‘o’. 

Now click and drag the blocks below, and edit 
their numbers, to build a script for Scratch Cat. 
This script runs when you click the green flag 
above the Stage. It sets the cat’s movement 
direction to up, puts the cat in the top-left corner 
of the Stage, and sets it to always face left or right. 
Then, the movement blocks inside the (forever 
bracket keep the cat moving all the time. 

Click the green flag to run your script. Scratch 
Cat will move to the left side and bounce up 
and down. 


north-west direction. Why not try starting a new 
project and joining some Motion blocks together 
to experiment? You can run a script or a block by 
clicking it, or use the when flag clicked block as 
we did in our program here. 
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02 Send a broadcast 

The moving objects in Scratch, including 
the cat, are called sprites. One sprite can senda 
message to all the other sprites using a broadcast. 
You can’t hear it or see it on screen, but sprites 
can listen for it, and then start a script when they 
receive it. We’ll use a broadcast to make the cat 
throw some bananas. Click the brown Events 
button, and add the two blocks below to the Scripts 
Area. This new script doesn’t join to the existing 
script (from Step 1) - it sits on its own in the same 
Scripts Area. 

You need to change ‘message1’ to ‘fire’. Click 
the down arrow next to ‘message1’ in the broadcast 
block and choose New Message. Enter the message 
name ‘fire’ and click OK. 

As the program is running, when you tap SPACE, 
the broadcast message is sent silently. Crafty! 


when ‘pace key pressed 


broadcast fire 


03 Add aerodynamic bananas 

Scratch enables you to get results fast 
because it includes its own images and sounds. 
Click the first New Sprite button above the Sprite 
List (it will display ‘Choose sprite from library’ as 
you hover over it). 


FEATURE 


change ‘core 


wait 1) secs 


Blocks Palette: Find 
instruction blocks here 


Scripts Area: Drag and 
drop blocks here to build 
cen PRE Se your script (program) 
wait @) secs 

stop all | Buttons: Click to view 
different types of blocks in 
the Blocks Palette below 


Sprite List: Select and 
manage sprites here 


Click the Bananas sprite to add it to the Sprite 


List. Notice that its Scripts Area is blank. We’ll Top TI p 
give Bananas two scripts. The first one sets the 

sprite’s size and makes it invisible when you click Get the 

the green flag. The second runs when the cat right sprite 


broadcasts its fire message. Click and drag the 


blocks below to the Scripts Area. Make sure you're 


adding scripts to 
the correct sprite. 
You can select a 
sprite by clicking 
clicked it in the Sprite List. 


When adding the block, drag the 
block inside the round ‘y:’ field to 
replace the ‘10’ default value. 

The ‘fire’ broadcast makes the bananas jump 
to the cat (use the go to mouse- pointer block, 
and choose Cat1 in its menu). Then it makes the 
bananas visible, glides them across the screen, and 
hides them again. 

Click the green flag, and tap SPACE to test. 
Scratch Cat now throws bananas. 
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The @ 


Top Tip 


Blocks inside 
blocks 


Some blocks can 
go inside other 
blocks. In Step 3, 
the y position 
block keeps the 
sprite’s y position 
the same while 
its x position 
changes. 
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clicked 
to 0) 


7c 
] 


when 


set score 


04 Add monkey magic 

Variables are names used to remember 
information, such as a score, that might change. 
Click the Data button and click Make a Variable. 
Give it the name ‘score’, select For All Sprites, and 
click OK. Let’s add a moving target for the cat to try 
to hit. Click the ‘Choose sprite from library’ icon 
and choose the Monkeyz2. Select Monkey2 in the 
Sprites area and give it the script above. 

The monkey’s script sets the new score variable 
to o when the game starts, then makes the monkey 
move up and down. Each sprite can have more 

than one image: the Next Costume block cycles 
through them, creating an animation. 


05 Add collision detection 
Our monkey will react when it’s 
struck by a bunch of bananas. To do that, 
we use an {if block; this checks whether 


clicked 


when | receive fire 


Learn to code 


We're huge fans of Scratch at The MagPi, so 
check out our past issues online for more Scratch 
tutorials. Issue 5 includes a memory game, like 
Simple Brian. Issue 34 has a multiple-choice quiz, 
and our 2018 Annual included an introduction 


to electronics and Scratch. See issue 76 for 
a roundup of resources to help you learn 
Scratch, and don't forget there's a Scratch book 
in The MagPi's own Essentials series 
(magpi.cc/learnscratch) and the Code Club Book 
of Scratch (magpi.cc/ccbookz). 


change score 


wait By secs 


something is true — in this case, whether the 
monkey is touching the bananas. If so, the blocks 
inside its bracket are run. Here, those blocks 
hide the monkey, add 1 to the score, and wait one 
second before showing the monkey again. 

This whole code chunk goes inside the monkey’s 
forever) bracket — below the block 
— so the program keeps checking whether the 
monkey has been hit. 


06 Finishing touches 

Let’s add a simple timer to stop the sprites 
moving after 30 seconds, and make the monkey 
react when it sees incoming bananas. Add these 
two scripts to the monkey sprite. Now the game is 
complete, why not try experimenting with it? Can 
you make the monkey move erratically instead of 
disappearing when it’s hit? Can you change the 
sprites’ positions and directions to turn the game 
sideways, making it more like Space Invaders? 
What about adding more targets to hit? One of the 
best ways to learn to code is by experimenting with 
existing programs. 
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Code a quiz game 


Make your own text quiz game that mangles famous 
ohrases using the Python language 


any people progress from Scratch 

to Python, a programming language me OM 

that is powerful, easy to get started New Load Run 
with, and much easier to read and write than 
other languages. 

We’re going to make a simple quiz question 
generator that strips the vowels and shuffles the 
Spaces in a phrase. The player has to work out what 
that phrase is. 

We’ll be using Thonny, which provides a 
friendly single-screen environment for running 
and testing Python code. Like Scratch, the Thonny 
IDE (integrated development environment) comes 
pre-installed in the Raspbian with Desktop and 
Recommended Software operating system. 


Thonny - /home/pi/190417 only connect.py @ 39:47 - © X 


OB & 


Debug Stop 


190417 only connect.py * Variables 
import random 


questions = ["As you like it", "The Tempest", “Measure for Measure", oleae sininaas 
group_length 


"Much Ado About Nothing", "The Comedy of Errors”, 5 
"King Lear", "Cymbeline", "Hamlet", "Coriolanus", "Othello", guess ROMEO AND JULIE 
“Love's Labour's Lost", "King John", “Julius Caesar", “Edward 
letter 0 


chosen_phrase = random.choice(questions) 
chosen_phrase = chosen_phrase.upper() 


puzzle 

puzzle_with_spaces THLL 
questions [As you like it, The 
random <module random’ f 
vowels 


puzzle vowels 


for letter in chosen_phrase: 
if not letter in vowels: 
puzzle += letter 


4 


Shell 
JLSCS R 


what is your guess? Julius Caesar 
That's correct! 


Create a list of questions iil 


O1 As well as variables, Python has lists, which 
can store multiple pieces of information. Our 


What is your guess? Romeo and Juliet 
No. The answer is OTHELLO 


>>> | 


program creates a list called questions. Each item 
in the list is a piece of text, known as a String. In Python, strings are surrounded by double quotes 

to show where they start and end. The whole list is 

enclosed in square brackets, and there are commas 

between the list items. Type in the code below, save 
your program, and then click Run. If it worked, you 


should see no error messages in the Shell window. 


om lyre in and edit 
your program 
code here 


02 Enter direct 
commands and 
see program input 
in the Shell here 


Keep track of the 
03 
data your program 


oo" random 
is processing here 


Python uses indentation to show which 
instructions belong to a function, an if statement, 
or a repeating section. As you can see in Step 3 
(overleaf), you can have multiple levels of 
indentation. The last line belongs to the if 
instruction, and that is repeated inside the for 
loop. The best way to get the indentation right is 
to remember the colon at the end of the previous 


questions — ["As You Like It", 

"The Tempest", "Measure for Measure", 
"Much Ado About Nothing", 

"The Comedy of Errors", 

"King Lear", "Cymbeline", 

"Hamlet", "Coriolanus", "Othello", 


You'll Need 


Raspbian with 
Desktop and 


line. Then, Thonny will add the indentation for you F é Recommended 
automatically. If you forget, use four spaces at the Love's Labour's Lost”, Software 
start of the line to insert the indentation. You'll still “King Jonh > Julius Caesar, Thonn’ 


need to fix that missing colon, though! "Edward III" | 
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Pesky 
punctuation! 


Take care to 
add the colons 
at the end of 
the if and else 
instructions. The 
code won't work 
without them. 


32 magpi.cc 


Where next? 


You can find Python code to dissect in most issues 
of The MagPi. |lssue 53 (magpi.cc/53) includes 
a more in-depth beginner's guide to Python, 


Pick a random question covering variables, looping with while and for, 

Python includes modules of prewritten branching with if, and functions, which we'll 

code you can use, such as the random module cover in this issue shortly. Issue 54 (magpi.cc/53) 

we imported in Step 1. The first new instruction introduces object-oriented programming in both 
: Scratch Python. | i.cc/ 

creates a new variable called chosen_phrase and a baat alba enle eat ona ca , 

Coe ; includes a roundup of Python books and online 
puts a randomly chosen question into it. The 


resources. There is a book in our Essentials 
second line converts the chosen_phrase to upper series too, called Make Games with Python 


case. Run the program a few times and look at the (magpi.cc/gameswithpython). 
value of chosen_phrase in the Variables pane. You 
should see different names come up, although 
names can also repeat. 


Add a line of space between the code in Step 1 list. If it is not, the letter is added to the end of 
and add the following code: puzzle. The += means ‘add at the end’. Run the 
program, then test it’s working by looking at the 
chosen_phrase — random.choice(questions ) contents of puzzle in the Variables panel. It should 
chosen_phrase — chosen_phrase.upper() contain no vowels, spaces, or apostrophes. 


Add the following code to the program: 


vowels [ . . ; . F i | 
Strip the vowels and spaces puzzle 
Let’s create a new list of forbidden 
characters, chiefly the vowels, but also the letter chosen_phrase: 
Space and the apostrophe. That last list item in letter vowels: 
the vowels list is an apostrophe inside double puzzle letter 
quotes. We create an empty string variable, called 
puzzle. We’re going to go through each letter in 
the phrase, check whether it’s in the vowels list, 
and if not, add it to the end of the puzzle string. Insert random spaces 
The for instruction sets up a repeating piece Each character in the string can be referred 
of code, called a loop. The instructions that to by its position number, starting at o. The number 
should be repeated are indented from left. Each is called an index, and you put it in square brackets 
time around the loop, the variable letter is after the string. Try this in the Shell (click on the 
set to contain the next character from the line starting with ‘>>>’). Instructions in the Shell 
chosen_phrase string. The if instruction are carried out immediately. Enter the following: 
checks whether the letter is in the vowels 
print( [1]) 


You get ‘e’ back (because the first character is 
number 0). You can get a chunk too (called a slice) 
by giving a Start and end index, like this: 


Debugging in Thonny 


You can step through the program slowly to see arnt Boe) 
what it’s doing, which can help you to find errors. 
Click the Debug button in Thonny, then click the It gives you ‘ell’ because the last index position 
Over button to run through each instruction in turn. (4) is left out. We’ll create a new list, called 
Watch the Variables pane on the right to see how puzzle with_spaces, by adding chunks of the 


the lists and strings change at each stage of the 
program. Thonny also helps you avoid errors by 
highlighting unclosed brackets and double quotes. 


puzzle string and a space until there’s no puzzle 
string left. The while loop repeats the indented 
instructions below as long as the length of puzzle 
is more than oO. The group_length variable is 
given a random whole number (integer) from 
1 to 5. Then that many letters are added 
to puzzle with spaces from the front of 
puzzle, plus a space. Those characters are 


Python Is easy to get started 
with and much easier to read and 
write than other languages 


then cut off the front of puzzle. The slicing here 
only uses one number, so the other one is assumed 
to be the start or end of the string. 

Add this code to your program: 


puzzle with spaces ~— 


while len(puzzle) > Q: 
group_length — random.randint(1,5) 
puzzle with _spaces — 
puzzle[:group length]  " " 
puzzle — puzzle[group_length: ] 


Add collision detection 

It prints the puzzle _with_spaces. It then 
uses the input() function to ask you what your 
guess is. Your answer goes into the guess variable, 
and is then converted to upper case to make sure 
it matches the correct answer if it’s right. The 
if instruction checks whether guess is the same 
as chosen_phrase. If so, it prints one message. 
Otherwise, the instruction indented under else 
runs, to tell you the right answer. In Python, one = 
is used to put a value into a variable, but two (== 
are used to compare items in an if instruction. 

Add this code to the end of the program: 


print(puzzle_with_spaces) 
guess = input("What is your guess? ") 
guess — guess.upper() 


~ guess ~~ chosen_phrase: 
print("That's correct!") 
else: 
print("No. The answer is ", chosen_phrase) 


Click the Run button and hopefully you’1l see some 
letters in the Shell and ‘What is your guess¢’ Enter 
an answer and you’ll see ‘That’s correct!’ or ‘No. 
The answer is’ and the correct response. 

If you’ve typed the code out by hand, it’s likely 
that you’ll see an error message. Go through your 
code line-by-line and compare it to the full code 
in quiz_game.py. 


quiz_game.py 


Language: Python 


001. 
002. 
003. 


004. 
005. 
006. 
007. 
008. 
909. 
010. 
Oi. 
Oi. 
013. 
014. 
Q15. 
016. 
017. 
018. 
G98 
920. 
Q21. 
Q22. 
923. 
Q24. 
O25. 
Q26. 
Q27. 
028. 
Q29. 
930. 
S/BuL 
G32. 
933. 
934. 


FEATURE 


impor’ random 


questions = ["As You Like It", "The Tempest", 
"Measure for Measure", "Much Ado About Nothing", 
“The Comedy of Errors", "King Lear", "Cymbeline", 


"Hamlet", "Coriolanus", "Othello","Love's Labour's Lost", 


"King John", “Julius Caesar", "Edward III" | 


chosen_phrase = random.choice(questions ) 
chosen_phrase = chosen_phrase.upper() 


vowels 
puzzle = 


[A Las lias Olen "Ue; W Bi ev 


for letter in chosen_phrase: 
if not letter in vowels: 
puzzle += letter 


puzzle with_spaces = 


while len(puzzle) > 0: 
group_length = random.randint(1,5) 
puzzle with _spaces +— puzzle[:group_ length] + 
puzzle — puzzle[group_length: ] 


print(puzzle_with_spaces) 
guess = input("What is your guess? ") 
guess = guess.upper() 


_* guess == chosen_phrase: 
print( That s correct! ~) 
else: 
print("No. The answer is 


,» chosen_phrase) 
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Build an LED torch 
and electronic game 


Discover how easy it can be to get lights blinking and buttons clicking using 
GPIO Zero and use your new-found skills to build an electronic game 


ne of the best things about the Raspberry Pi is the yellow wires in the diagram. The first button 
0) that you can easily hook up your own electronics connects to the GPIO 2 pin on one side, and to 
projects. Using some electronics components and the ground rail on the other side. We’1l connect 
the GPIO Zero library, you can program a puzzle game the latter to a ground pin on the Pi, so anything 
where you have to repeat a sequence of lights that plugged in that row of holes connects to ground. 


gets longer each turn. You might remember a similar 
electronic game from your childhood, but we call ours 
Simple Brian. In issue 77 (magpi.cc/77) we showed 


you how to use Python code to play the game on Connect your first LED 
screen. This issue, we’ll show you how to make the Always use a resistor when you connect an 
electronic game itself, building on your new-found LED to your Pi, to prevent the LED drawing too 
Python skills from Missing Vowels. much current and getting damaged. Both the LED 
First, we’re going to show you how to build a and the resistor plug straight into your breadboard. 
torch by lighting up LEDs. Let’s get going. The current flows from GPIO 18, through the 


resistor, through the LED (lighting it up), to the 
breadboard’s ground rail. LEDs only work one way 
around: the short leg is the negative side, which 
Connect your first button you connect to ground. The LED won’t light up yet. 
The torch circuit diagram (Figure 1) 
shows an LED light connected to the GPIO 
pins of a Raspberry Pi using a breadboard 
You'll Need (see magpi.cc/breadboard for a primer Make an LED torch 


on using this piece of equipment). You’ve made your first circuit! Let’s test it 


2 Be DS cles Press the button into the board, by coding a torch. The torch. py code shows how to 
different colours) : : : 
then use jumper wires to form a use an LED and a button. It imports the relevant 
> 4 x 330 Q resistors circuit with your Pi, as shown by parts of the GPIO Zero library, then sets up an LED 


> 4x 6mm Tactile called light, connected to GPIO pin 18. The button 
momentary On pin 2 is set up with the name button. The while 
button switches True loop checks whether the button is pressed 

> 400-point forever. If so, the light is turned on. Otherwise, it’s 
breadboard turned off. Pay attention to the capitalisation of 

ae Matetionremiale LED and Button when setting them up. 
jumper cables The online documentation for GPIO Zero 

(magpi.cc/DPyuYc) provides more code 

> 8 x Male-to-male examples, including a button-controlled camera, 

jumper cables an LED bar graph, and a motion sensor. We 


< Jsleeeecra= watian surveyed useful resources for basic electronics Add the other buttons and LEDs 


BRAG in issue 77, and there's a book in our Essentials Take a look at Figure 2 (overleaf). It looks 
pimoroni.com series called Simple Electronics with GPIO Zero complex at first, but the other three buttons 
(magpi.cc/gpio-zero). and LEDs are connected in the same way as 


11 abs 


4 ta 
a Jeet ae" 
fh ‘Le eS as 2 . 


A The finished game, with all the lights lit up for testing 


the first ones, just using different pins on the Pi. 
All the buttons (yellow wires) connect to the Pi’s 
inner row of pins, and the LEDs (blue wires) to the 
outermost row. We’ve separated the components 
in this diagram a bit so it’s easier to see how to 
wire it up, but try to line up your LEDs and buttons 
on the breadboard so it’s easier to play the game. 


Test them all 

Now you can test these LEDs and buttons 
too. Modify your torch code to use LED(23) and 
Button(3) and then run the program to test the 
next light switch works. Then check LED(24) and 
Button(4), and finally LED(25) and Button(17). The 
buttons should be next to the LED they illuminate. 


Build an electronic game 

Now we’re ready to start making the Simple 
Brian game (see brian.py). This starts by setting up 
a list of buttons, and a list of their associated LEDs. 
It also creates an empty list called sequence, which 
we’ll use for the sequence of lights the player must 
repeat. With each turn, it’ll get longer. 


Add functions 


Functions enable you to bundle up a set of 
instructions so you can reuse them. You have to 
define a function before you can use it. To define 
a function, you use def, followed by the function 
name, (), and a colon. The brackets are there to hold 
any info you’re sending to the function, but we don’t 
need to send any so they’re empty. You can tell 
which instructions belong to a function, as they’re 
indented. The lights _on() and lights_off() 
functions use a loop to go through all the items in 
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Count the pins to see where to connect 
your wires 


The breadboard makes it easy to plug In 
components and quickly set up circuits 


Using this simple circuit (with an LED anda 
button), you can make a push-button torch 


torch.py 


Language: Python magpi.cc/github82 


# Torch demo 
Q02. ~rom gpiozero impors Button, LED 
003. 

Q@@4. light - LED(18) 

Q@5. button = Button(2) 


006. 

007. while True: 

008. i+ button.is_ pressed: 
Q09. light.on() 

010. else: 


light.off() 
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the leds list, putting them into led, then turning 
led on or off. The flash_al1() function shows how 
to repeat a set number of times, in this case 3. The 
loop turns the lights on and off, with a 0.25 second 
pause after each change using sleep(@.25). 


LINYSHLI 
CSI (CAMERA) 


x2 @Sn 
BEESRERRERREEES 


CAVIdSI@) IS 


Lights test flash all 


After you’ve entered the functions (down 

to line 23), you can test the program by adding 
flash_all1() as the last line and then running it. 
All the lights should flash together, three times. 
Delete that test line before you carry on. In line 

25, the program runs the lights_of#f() function to 
ensure the lights are all off before the game begins. 


GLOz !d Auaqdsey © 
ZT LAG |aPOW € Id Auuaqdsey 


Add to the sequence 

Now we enter the main game loop, under 
while True (line 27). Everything from here on in is 
indented to show it belongs to that loop, repeating 
endlessly. The game sequence Starts as an empty 
list, so the first thing we do is to add an LED. We 
pick a random LED using random. choice() and 
add it to the end of the sequence list using the 
append() list method. A list method is a built-in 
Python function that you can apply to a list. Other 
1 Just like its famous namesake, our Simple Brian methods are available to insert and remove items, 


Sacer aera aa pee ee and sort the list, among other things. 


The circuit also contains four buttons. We'll 
push these to repeat the sequence of lights that 
we've memorised 


At the heart of our project is the Raspberry Pi. Play the list sequence 


The buttons and lights are connected to our The lights all flash three times using the 
computer with wires. Code in the computer flash_all() function before the sequence begins, 
flashes the lights and keeps an eye on the he 

buttons we're pushing to show this is the start of the sequence. Then a 


loop is used that takes each LED from the sequence 
list, and puts it into light, in turn. It’s turned on, 
there’s a short pause, then it’s turned off. There’s 
another short pause so it’s obvious there are 
multiple flashes of the same light if it repeats in the 
HTT TTT sequence. In round one, there’s only one light in 
the sequence list, but as the game progresses, this 


loop will get longer. You can run the program at this 
point to see the light sequence gradually extend, 
without the player getting a chance to guess. 


Get the player’s guess 
edges are connected in a long line, : ) ss 
Een ey nea et Ca a Getting the player’s guess uses a similar 
middle are connected to each other loop to the one that plays the lights sequence. It 


A Ona breadboard, the rails along the 
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Language: Python magpi.cc/github82 
Q01. ‘rom gpiozero import Button, LED Q34. 
Q02. ~rom time import sleep Q@35. # play the sequence 
Q03. import random Q36. for light in sequence: 
204. Q37. light .on() 
@@5. buttons = [Button(2), Button(3), Button(4), Q38. sleep(@.5) 
Button(17) | Q39. light .off() 
@@6. leds = [LED(18), LED(23), LED(24), LED(25)] e4e. sleep(@.25) 
007. 041. 
Q08. sequence — [] Q42. # get the player's input 
209. 043. for light in sequence: 
Q@10. def lights _on(): 044. guess = None 
Q11. for led in leds: Q45. while guess == None: 
Q12. led.on() 046. for button in buttons: 
Q13. Q47. if button.is pressed: 
Q14. def lights off(): 048. # convert button push to list 
Q15. for led in leds: index number 
Q16. led.off() Q49. guess = buttons. index(button) 
017. 050. 
Q@18. def flash_all(): Q@51. “+ leds[ guess] == light: 
Q19. for _ in range(3): Q52. light.on() 
Q@20. lights_on() Q@53. sleep(@.5) 
Q21. sleep(@.25) Q54. light.off() 
Q@22. lights_off() Q@55. sleep(@.25) 
Q@23. sleep(@.25) Q@56. else: 
Q24. Q57. print("You failed at level ", 
Q@25. lights off() len(sequence) ) 
Q26. Q58. for _ in range(1@): 
Q@27. while True: @59. light.on() 
Q@28. # Add a new light to the end of the sequence 060. sleep(@.15) 
Q@29. new_light = random. choice(leds) Q61. light .off() 
Q30. sequence. append(new_light) 62. sleep(@.15) 
Q31. 063. sequence = [] 
Q@32. # Flash all before playback 064. break 
Q33. flash_all() 


works its way through the sequence list, accepts a 
guess, and checks whether it matches the current 
item in the sequence. There are three loops inside 
each other here. The program sets the guess 
variable to None, a special value in Python. Then 

a while loop keeps repeating until the guess 
variable changes. Inside that, a loop goes through 
the buttons list, checking each one in turn to see 
whether it’s pressed. If so, the guess variable is 
changed, ending the while loop. The program 
converts the button the player pressed into its 
index number in the list and puts that into the 
guess variable. That way, we can match the button 
to its LED, which will be at the same position in the 
leds list. You can find the position of an item ina 
list using listname.index(item). 


Check the player’s guess 

We’re still inside the loop going through 
the sequence here, as the indentation of line 51 
shows. Now we check whether the light the player 
guessed (leds[ guess ]) matches the current light in 
the sequence. If so, the light is turned on and then 
off again. If the two lights don’t match, the player 
made a mistake. We can tell how long a list is using 
len(listname). We use the length of the sequence 
list to tell the player which level they got to. The 
correct light is then flashed quickly ten times. The 
sequence list is emptied to start a new game, and the 
break instruction breaks out of the for loop that’s 
getting player input. When the player has either 
guessed all the lights, or failed, the game repeats 
from line 28, adding a new light to the sequence. M 


TopTip @& 


Underscoring 
repetition 


The line for _ in 
range(3) repeats 
the indented 
instructions three 
times. The _ 
shows we don't 
need to use the 
Loop number. 
Often, you'd 

use a variable 
name instead. 
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The Pi Zero's size means 
it's a comfortable 
addition to a keyring 


PJ is a writer, 
Jammer, and loves 
vintage computing. 
He is never more 
than five metres 
away froma 
Raspberry Pi. 


@mrpjevans 


Pi keyring 


You can still access the 
microSD card so your Pi 
can be multi-purpose 


Need a Raspberry Pi in your grab-bag? Here's how you can get 
gq P| up and running and networked just about anywhere 


Ithough our beloved Pi is rightly praised 
for its diminutive nature, the need for 

a keyboard, mouse, and monitor can 
somewhat spoil the portability. If you’ve ever 
had a moment thinking, “If only I had a Raspberry 
Pi with me right now”, this is the project for you. 
More than just a Pi-in-a-pocket, we’re going to 
create a travel-ready Pi, free of peripherals but 
with full desktop support, that can join the local 
network either via its own WiFi hotspot, ora 
hidden feature of Raspbian: USB networking. 


A 


Prepare the Pi 

Even though our portable Pi will not require 
a keyboard, monitor or mouse (well, sort of, you’ ll 
see), we want to get the most out of the device, 
so start by getting the full ‘Raspbian Stretch with 
desktop and recommended software’ image from 
the Raspberry Pi website (rpf.io/raspbian). Write 
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it toa microSD card using your favourite utility 
(we used balena Etcher — balena.io/etcher). 
However, just to show that it’s possible to do all 
this without ever hooking the Pi up to a monitor, 
don’t boot up just yet. 


Set up for headless 

Reinsert the microSD card into your 
computer. It will mount a drive called ‘boot’. We’re 
going to make some changes so the Pi starts with 
both WiFi and USB networking enabled. That’s 
right, Raspbian has a feature that allows it to act 
like a network device to any computer connected 
by USB. Simply connect the Pi to your computer 
with a USB cable and a private network is set up 
between them, giving headless access without 
needing to get the Pi on the network. It’s not 
enabled by default, so we’ll make some changes to 
files in the boot directory to fix this. 


= 


nage : 


A The pre-installed VNC server streams the Pi's desktop user 
interface to any other computer on the network 


Enable WiFi and SSH 


In the boot directory, create a file called ssh, 
with no extension. It doesn’t need any content. On 
UNIX-style systems, you can enter: 


touch ssh 


Now, using a text editor, create a file in the same 
directory called wpa_supplicant.conf and enter 
the following (change country code if appropriate): 


country=gb 
update_config=1 
ctrl_interface=/var/run/wpa_supplicant 


network={ 

scan_ssid=1 

ssid="Your network name" 
psk="Your network password" 


} 


Replace the values of ssid and psk to match your 
WiFi network name and password. 


Size matters 

When a Pi boots without a monitor attached 
(headless), the desktop still starts, but at a very 
small screen resolution. We’re going to be using 
VNC to remotely access the desktop, so we need 
to make it a bit more usable. Using a plain- 
text editor, open the file config.txt in the boot 
directory. Be very careful making changes here as 
it can render your Pi unbootable. Scroll down the 
file until you see two lines as follows: 


#framebuffer_width=1280 
#framebuffer_height=720 


™ We're going to create a 
travel-ready Pi, free of 
peripherals But with Tull 
desktop support 


Note the ‘#’ before them; this marks them as 
comments and so they are ignored. Remove the ‘# 
so it looks like this: 


) 


framebuffer_width=1280 
framebuffer_height=720 


Enable USB networking 
Scroll down to the bottom of the config.txt 
file and add the following line: 


dtoverlay=dwc2 


This instructs Raspbian to apply the USB 
networking module. Save and close config.txt. 
To make sure the module is made available, edit 
the file cmdline.txt, also in the boot directory. 
The contents of the file are on a single line. Find 
the end of the line and, making sure you do not 
add a new line in the process, add a single space 
followed by: 


modules-load=dwc2,g ether 


Now save and close cmdline.txt, then eject the 
microSD card. 
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[ You'll Need 


> micro USB to USB 
cable 


> LiPo SHIM 
(optional) 
magpi.cc/zaMZab 


> LiPo battery 
(optional) 
magpi.cc/FOuZmb 


>» Keyring case 
magpi.cc/hqjqdE 


WV Pimoroni’s LiPo SHIM 
allows safe use of a 
LiPo battery without 
blocking GPIO ports 


Les oase2" TSS omAn 3-7 
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Easy WIFi 
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USB networking 
gives youa 
reliable method of 
setting up the Pi's 
WiFi connection if 
you want to give 
others access. 


V_ Using a 3D printer, 


you can customise 
and create your 
own case 


y= Connect via USB 

ate It’s time to wake up our Pi. Insert the 
microSD card into the Pi and connect a micro 
USB cable to the peripheral USB port on the Pi 
Zero, not the usual power USB port. If you’ re 
unsure, the peripheral port is the one nearest the 
mini-HDMI connector. We need full USB access 
for networking, and your computer will also 
supply enough power to keep the Zero happy. 
Connect the cable to your computer and wait a few 
minutes so Raspbian has time to resize the file 
system and set things up. 


7! Log in 

‘wie From the command line (users of 
Windows 8 or before may need to install PuTTY), 
run these commands: 


ssh-keygen -R raspberrypi.local 
ssh pi@raspberrypi. local 


The first command cleans out any previous SSH 
keys you may have for raspberrypi.local. You do 
not need to run it again. Hopefully you’1] now be 
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prompted for a password. Enter raspberry and 
you’ re in. If you find you can’t connect to the 

Pi, re-examine the changes you’ve made to the 
boot directory or try booting with a monitor and 
keyboard. You may connect through WiFi rather 
than USB. Run ifconfig at the Pi’s command line 
to see the different networks. 


*)-) Configuration 
wuts We’ve established we have headless access 
to the Pi Zero. While you are logged in, start with 


some housekeeping. Run this command: 
sudo raspi-config 


Firstly, change your password from raspberry to 
something harder to guess. Now go to ‘Network 
Options’ then ‘Hostname’. Here you can rename 
your Pi to something else if you wish, reducing the 
risk of it clashing with another Pi on the network. 

Finally, go to ‘Interfacing Options’ and enable 
the VNC server. This will allow you to stream the 
desktop to another device. Reboot the Pi now so 
the host name change takes effect. 


N 


A lf you need GPIO access, the official case is perfect with its 
selection of covers. Make two small holes for a thread loop 


Desktop access 

To stream the Pi desktop, you’ll need a 
client for your connected computer. A popular 
choice is VNC Viewer, available for a wide range of 
platforms from magpi.cc/FuGnye. Once installed, 
enter your Pi’s new host name followed by ‘. local’ 
as the server and press ENTER. In a few seconds, 
the desktop will appear on your screen. 

You should see a ‘Welcome to Raspberry Pi’ 
dialog box. Now’s the time to go through these 
menus and also update the current software 
when prompted. The Pi will need a working WiFi 
connection to do this. 


Hotspot access 

If you want a truly standalone experience, 
and internet connectivity isn’t a concern, another 
connection option is to use the Zero’s WiFi 
capability and create a hotspot. Then, no matter 
where you are, so long as you can get power to the 
Pi, any computer will be able to connect and SSH 
or VNC in. 

Setting up a hotspot doesn’t take long, but 

does involve several steps, including setting 
up a DHCP server and hostapd. Take a look at 
magpi.cc/BRdGKK for a comprehensive guide. 
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™ To stream the Pi desktop, you'll need a 
cllent for your connected computer. A 
popular choice is VNC Viewer 


Batteries are included? 

If you are taking the hotspot route, why not 
go the whole nine yards and add battery power? A 
Zero will run quite happily for hours from widely 
available USB power banks. If you’re feeling fancy, 
why not add in a LiPo battery so you have a single 
self-contained unit? LiPo batteries come with 
safety concerns (see ‘LiPo safety’ box), so we need 
some circuitry to manage the battery and make 
sure it supplies the correct voltage. Pimoroni’s 
LiPo SHIM does just this with the added bonus 
of not using up any of your valuable GPIO ports. 
Carefully solder it to the base of the GPIO pins and 
you’ve got power. Don’t forget to add a switch. 


Print a case 

Obviously, we can’t leave our little Zero 
unprotected, so our final step is to provide a nice 
case. If you’re wanting to use GPIO, the official case 
can be adapted to accept a keyring with a small 
drill bit and a steady hand. If you’ve added battery 
power, it may be time to get a CAD package out and 
design something that fits everything into one. 
We opted for a 3D-printed case (magpi.cc/hqjqdE) 
from Thingiverse maker Haunt Freaks, which 
features a ready-to-go hoop to accept a keyring or 
lanyard clip. 


A Always be careful 
editing the files in 
the boot folder. Take 
backups and use 
a text-only editor 
like nano 


TopTip @ 


Add a NAT 
gateway 


You can configure 
the connected 
computer to 
route internet 
traffic to and 

from the Pi using 
network address 
translation (NAT) 
routing software. 


A Pi Zero without 
headers means an 
extra slimline case 
with no pointy bits 
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Madei 


va 


Rob 
Zwetsloot 


Rob is amazing. 
He's also the 
Features Editor 

of The MagPi, a 
hobbyist maker, 
cosplayer, comic 
book writer, and 
extremely modest. 


magpi.cc 


You'll Need 


> NeoPixel lights 

> Circuit wire 

> Push-button 

>» 470 Q resistor 

> 5V power source 


> Soldering iron 


NeoPixel display 


cabinet lights 


Light up g display cabinet with some NeoPixels, a Raspberry 


P|, and a little Python code 


e’ve covered NeoPixels in The MagPi 
W before, with some wonderful cosplay 

lights (magpi.cc/45) and Christmas 
tree lights (magpi.cc/52), which we’ve used 
ourselves. It’s been a long time since we’ve 
controlled any NeoPixels with a Raspberry Pi, 
though - so long that there’s actually a newer and 
much easier method for doing it. 

We thought it was high time to try this out, and 

get a display cabinet lit up fancily in the process. 


Choose your NeoPixels 
There are many configurations and types 


of NeoPixels that you can buy. For our display 
cabinet, we chose two quarter-circle stripes of 
lights that hold 15 LEDs a piece. This allowed us 


A Figure 1 This diagram shows 
the rough circuit for our 
setup, and should be used as 
a guide for your own 
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to create a little semicircle in our cabinet for a bit 
more interesting coverage. 

If you have a big cabinet and wish to line the 
entire thing, you can always get a long flexible 
strip of NeoPixels. You can even get single lights, 
or smaller circles of NeoPixels. 

The only thing you need to make sure you do 
for all the NeoPixel types is correctly count the 
number of LEDs in your system. We’|I tell you why 
in a few steps’ time. 


Choose a location 

What do you want to light up® For our 
project, a shelf of figurines was all we wanted to 
illuminate, and so we decided to add the lights 
above the shelf — attached to the ‘ceiling’, as 

it were. 

You’ ll need to take into consideration light 
coverage and camouflage in your display cabinet. 
Think about sight lines if you want to keep them 
hidden from specific angles, and look to see if your 
display cabinet has anything to aid in adding lights 
— the IKEA Detolf has a little plug on the top for 
wires, for example. 

There also needs to be access for the Pi to 
control the lights, so Keep that in mind. 


Assemble your circuit 
We’ve put together a handy circuit diagram 
(Figure 1) for you to follow along to. There are a few 
important things to note, though, to make sure you 
understand it. 

The NeoPixel strips have three pads on them: 
one for 5V power, one for ground, and a ‘data’ 
port. The data needs to be connected to the GPIO 


Using the Raspberry Pi, we 
can easily control a strip of 
multicoloured NeoPixel LEDs 


pin we’re sending the signals from. You also need 
to make sure to connect it to the Din (data in) pad. 
If you’re chaining together strips like we’ve done, 
make sure you connect the Dout (data out) from 
the first strip to the Din of the next strip. It’s also 
eood practice for ground on the NeoPixels to go to 
the Raspberry Pi’s ground, as well as the ground of 
the power source. 

We’ ve placed the button way down the GPIO 
pins to keep it clear. You need the resistor in the 
little button circuit to make sure it works properly 
and can be sensed by the Raspberry Pi. 


Soldering the NeoPixels 

This bit can be tricky, but you will have to 
solder some wires to your NeoPixel strips. Make 
sure your soldering iron is properly prepared if 
this is your first time using it (check this video: 
magpi.cc/GCUNyL). Also, if this is your first time 
soldering, check out the Raspberry Pi Foundation’s 
video on it: magpi.cc/Ahvxdk. 

We recommend putting a little solder on your 
wire (this is called tinning it), as well as a dab on 
the pads. That way, you just need to heat up the 
solder already on the wire and pad so that they fuse 
and connect. 


Powering the system 
You need to power two parts of your light 
display: the Raspberry Pi and the NeoPixels. The 
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The NeoPixels are 
programmable LEDs 
that can display any RGB 
colour that you choose 


RGB colour 


Red, green, 
and blue lights 
make up a single 
NeoPixel. Using 
a value of each 
colour between 
O and 255, you 
can create an 
entire rainbow 
of colours. 


™ You need to power two parts of 
your light display: the Raspberry PI 
and the NeoPixels 


NeoPixels require a 5V input, and also draw a lot of 
power at the same time; so, to be safe, you really 
shouldn’t power more than two or three NeoPixels 
with the 5V pin of the Raspberry Pi. In our circuit, 
we ve used four 1.5 V AA rechargeable batteries, as 
they’re technically closer to about 1.2 V each — that 
means we get roughly 5V out of them. 

A more convenient way is to get a5 V power 
supply and use a power terminal with two screw 
ports to attach the positive and negative ends. 
Please make sure the power supply is unplugged 
while you do this, and be very careful when 
plugging it in. 

You can technically run a Pi using the GPIO pins; 
however, we have elected to run a micro USB cable 
up to our Pi. 


Basic code 

We’ ve written the code, rollcall.py, to 
work with our specific system. Download it from 
magpi.cc/DisplayLights and we’|] run through it. 

First, we import the generic stuff: time, 

gpiozero, as well as the neopixel library and its 
related board library. We’ve also used the numpy 
library so that we can create RGB values for the 
LEDs, which enables them to fade between colours. 
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> Weused Blu Tack to 
attach the lights to 
the top of our cabinet 


TopTip @ 


Roll call 


The six colours 
chosen represent 
the main team 
of figurines in 
the cabinet - 

it's a tradition 

in Japanese 
superhero TV 
shows to run 
down your name 
and colour ina 
specific order. 


Our system uses 30 LEDs, and we’ve connected 
it to GPIO 18 on the board. We’ve then defined six 
colours that represent the figurines in the display 
for our added colour cycle effect. After that, we tell 
the code about the strip of NeoPixels. 

We then define how to calculate the values 
for colour fading, and the colours to transition 
between, before turning the strip of LEDs to pure 
white. Finally, we set the main rollcall_cycle 
function to loop, so we can press the button 
whenever we want. 


07 Alter your code 
The main parts of the code to pay attention 
to are the LED_COUNT, LED_PIN, and button values. 
Your number of LEDs will likely differ from ours, 
and you may have connected the strip and button 
to different GPIO pins. 

As for the colour cycle, play around with that 
to your heart’s content, or remove it completely! 
You can even change the main colour value for the 
standard lights, using RGB values from 0 to 255. 


Testing your lights 

Before attaching everything to your cabinet, 
we highly recommend testing your LEDs. Run the 
code from within your preferred Python IDE, and 
make sure that not only are you getting the correct 
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colours (you may have a GRB set of NeoPixels 
instead of RGB, for example), but that also the 
button works. 


Final Pi prep 

The Raspberry Pi in our setup is going to be 
headless, which means we want the Python code to 
load up after the Pi turns on. Our preferred method of 
doing this is adding a line to /etc/profile — it makes it 
a lot easier. Open up a Terminal window and type: 


sudo nano /etc/profile 
Use the arrow key to go to the bottom, then add: 
sudo python rollcall.py 


If you’ve saved the Python script to a specific 
folder other than the home directory, make sure 
to include the path to it as well. Save and exit the 
file. You can also turn off ‘boot to desktop’ in the 
Raspberry Pi configuration settings, so that the 
entire system loads up faster. 


Mounting the lights 

Depending on your NeoPixels, you can 
attach them in several different ways. We’ve used 
Blu Tack to stick ours to the ceiling of our display 


rollcall.py 


>» Language: Python 


0901. #!/usr/bin/env python 

02. 

Q03. import time 

204. 

Q0@5. from gpiozero import Button 
Q06. 

Q07. import board 

Q08. import neopixel 

Q@09. import numpy as np 
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y) magpi.cc/DisplayLights 


Q30. colour2 = np.array(colour2) 
Q31. vector = colour2-colour1 
Q32. newcolour = (int((colour1 + vector*percent) 


[@]), int((colour1 + vector * percent)[1]), 
int((colour1 + vector * percent)[2])) 

Q33. return newcolour 

Q34. 

Q@35. # Create a function that will cycle through the 
colours selected above 


Q10. Q36. 
Q@11. button = Button(21) Q@37. def rollcall_cycle(wait): 
Q12. Q38. for j in range(len(gokai_colours)): 
Q@13. # LED strip configuration: Q39. for i in range(1@): 
Q@14. LED COUNT = 30 # Number of LED pixels. 042. color1 = gokai_colours[j] 
015. LED PIN = board.D18 # GPIO pin 041. if j == 
Q@16. LED BRIGHTNESS = 0.2 # LED brightness 042. color2 = (255,255, 255) 
Q@17. LED _ORDER = neopixel.GRB # order of LED colours. 043. else: 
May also be RGB, GRBW, or RGBW 044. color2 = gokai_colours[ (j+1) ] 
018. Q45. percent = i1*0@.1 # 0.1*100 so 10% 
Q@19. # The colour selection selected for this increments between colours 
project: red, blue, yellow, green, pink, and 046. strip.fill((fade(colour1,colour2, 
Silver respectively percent) ) ) 
Q@20. Q47. strip.show() 
Q@21. gokai_colours = [(255,0,0),(@,0,255),(255,255,0) 048. time. sleep(wait) 
» (0, 255,0), (255,105,180), (192,192,192) ] Q49. 
Q@22. Q@50. strip.f111((255,255,255)) 
Q@23. # Create NeoPixel object with appropriate Q@51. strip.show() 
configuration. Q52. 
Q@24. strip = neopixel.NeoPixel(LED PIN, LED COUNT, Q@53. # Main function loop 
brightness = LED_BRIGHTNESS, auto write=False, Q54. 
pixel order = LED ORDER) Q@55. while True: 
Q@25. Q56. 
Q@26. # Create a way to fade/transition between Q57. time.sleep(1) 
colours using numpy arrays 058. 
Q27. Q@59. button.wait_for_press() 
Q@28. def fade(colour1, colour2, percent): 260. rollcall_ cycle(@.2) # @.2 seconds between 
Q29. colour1 = np.array(colour1) colour updates 


case; however, you could also use glue. For the long 
strips, you can always nail them in with staples so 
that you don’t actually have to go through the strip. 

Just make sure any exposed PCB is not touching 
anything conductive. 


Permanent circuit tips 

You don’t really want exposed wires 
everywhere just to light up your display case. 
Creating a 3D case to house the Pi is a good first 
step, and using heat-shrink tubing to encase all the 


cables makes the whole thing a lot neater. You can 
also cover any soldered joints with a bit of hot glue. 


Have fun and experiment! 

This basic setup can very easily be expanded 
upon. As the Pi is internet-connected, you’ ll be able 
to use some IoT stuff like Twitter triggers or noise 
activation or temperature-dependent colouration. 
You can even add more strips to the Pi so that you 
can have several layers of lighting effects. We hope 
this really improves your display cabinets. Wl 
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Mike 
Cook 


Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, 

and Raspberry 

Pi Projects 

for Dummies. 


magpi.cc/TPaUfT 


You'll Need 


» Lego 17101 Boost 
Creative Toolbox 
magpi.cc/JtUiDe 


> USB MIDI lead 
magpi.cc/fZiGvF 


>» MIDI sound 
generator 


> Optional cardboard 
and paint 


Hack Lego Boost 
with Raspberry P1 


Make a MIDI seguence generator that creates seguences 


from our small mobile rover: Si-clops 


projects where we explored the finer points 

of control that are normally hidden from 
you by the standard Lego software. In this final 
part (at least for now), we will look at making a 
MIDI sequence generator that creates sequences 
by letting a small mobile rover loose over any flat 
surface, as we introduce you to Si-clops. 

Figure 1 shows Simon; he’s always asking 
people about colours. However, this month the 
one-eyed Simon rides his colour-sensing Si-clops 
to generate music sequences from what it sees. 
This can be by roaming over existing artwork or 
scanning a set of coloured tiles placed in a tile 
holder. The sound is generated from a MIDI sound 
module attached to the Raspberry Pi with a USB 
MIDI lead. Once playing, the sequencer turns each 


ast month we looked at three example 


es 
es oo 


This part is the 
Boost's colour sensor 
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colour into a note of settable pitch, velocity, and 
instrument at a rate determined by the tempo 
parameter. The sound from each colour can also be 
individually muted. 


The theory 

The Boost system can recognise six different 
colours and if we have a sequence of eight steps in 
length, we get an enormous number of possible 
sequences. In fact, the number of possible sequences 
is six (the number of different colours we have in 
each place) raised to the power of eight (the number 
of steps that make up our sequence). Which, in 
terms of hard numbers, is 6°, giving a total of 
1,679,616 different possible combinations. As we 


Figure 1 


Press to connect 
and to create a 
sampling scan 


A Figure 1 Meet 
Simon, or Si for short 


Si-clops.py 


>» Language: Python 3 


001. 
002. 
003. 
004. 
905. 
006. 
007. 
008. 
909. 
010. 
O1T, 
012. 
013. 
014. 


Q15. 
016. 
Q17. 


018. 
Q19. 
920. 


O21. 


Q22. 
023. 


Q24. 


O25: 


Q26. 


Q27. 
028. 
Q29. 
930. 


931. 
O32. 


033% 
934. 
Q35. 
936. 
Q37. 
038. 
039, 


040. 


041. 


042. 
043. 


#!/usr/bin/env python3 

# coding=utf-8 

# Siclops Colour Sequencer 
# By Mike Cook April 2019 


import time, pygame, os 

from pylgbst import * 

from pylgbst.movehub import MoveHub, COLORS 
from pylgbst.peripherals import EncodedMotor 
import rtmidi 


midiout = rtmidi.MidiOut() 

pygame. init() 

pygame.display.set_ caption( 

"Si-clops -> Colour Sequencer") 

os.environ[ 'SDL_VIDEO WINDOW _POS'] = ‘center’ 
pygame.event.set_allowed(None) 
pygame.event.set_allowed([pygame.KEYDOWN, pygame. 
QUIT , pygame .MOUSEBUTTONDOWN, pygame . MOUSEBUTTONUP ] ) 
screenWidth = 43@ ; screenHight = 400 

cp = screenWidth // 2 

screen = pygame.display.set_mode([screenWidth, 
screenHight ],0, 32) 

textHeight=18 ; font = pygame.font.Font(None, 
textHeight ) 


samples = 8 3; step = © ; midiStep = @ ; newScan = 
False ; motorUpdate = True 
backCol = (160,160,160) ; lineCol = (128,128,0) ; 
hiCol = (@,255,255) 
tileColours = [ (@,0,0), backCol,(0,0,@), 
(0,0,255), (128,128,255), (0,255,255), 

(0,255,0), (255,255,0), 
(255,128,0), (255,0,0), (255,255,255) ] 


scannedBlock = [3,10,9,0,7,6,9,10] 
colourToTrack = [5,-1,-1,0,-1,-1,1,2,-1,3,4] 
chan = [1]*6 3; velocity = [64]*6 ; mute = 
[False]*6 

note = [56+i for i in range(@,6) ] 

lastNote = [0] * samples ; lastChan = 

[-1] * samples 

shutDown = False 3; update = False 

nextStep = time.time() ; tempo = 200 # BPM 
running = False # MIDI sequencer 
lastColour = 255 3; updateColour = @ 
tileDistance = @.@ 3; currentMotor = @ 


noteNames = [oy Ce y > Oe g By Py Pe gs 5 
"GH" ; ma” ; “AR” "B" | 
", "Harpsichord", "Glockenspiel", 


instNames = ["Piano", 
"Marimba", "Bells", "Organ", "Guitar", 
"Bass", Timpani", "Percussion", "Alto Sax", 
"Clarinet", "Rain", "Goblins", 
"Banjo", "Tinkle Bell" ] 
|O, 6,9; 12,14, 19,27,32,47,52,65, 71,96, 


insNums = 


044. 
Q45. 
046. 


Q47. 
048. 
Q49. 
Q50. 
Q51. 
Q52. 
Q53. 
954. 
Q55. 


Q56. 
Q57. 
058. 
Q59. 
060. 
061. 
062. 
063. 
064. 
Q65. 
066. 
067. 
068. 
069. 


970. 
Q71. 
Q72. 


073. 
Q74. 
Q75. 


076. 
Q77. 
078. 
Q79. 
080. 
081. 
082. 
083. 
084. 
085. 
086. 


087. 
088. 
089. 
990. 
991. 
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101,105,112] # to match above 


def main(): 
global update,movehub, shutDown, step, 
currentMotor, conn 
print("Si-clops - Colour sensor sequencer") 
print("press the green button now") 
conn=get_connection_auto() 
print("Looking for Hub") 
movehub = MoveHub(conn) 
print("Hub connected") 
init() 
initMIDI() 
print( 
"Initialised - Press green button to scan") 
drawScreen() 
while not shutDown: 
checkForEvent () 
if newScan: 
sensorScan() 
if time.time() > nextStep: 
doMIDIstep() 


def doMIDIstep(): 
global nextStep, midiStep, lastNote, lastChan 
if not running: 
time.sleep(@.1) # yield for other programs 
return 
tileNumber = colourToTrack[ 
scannedBlock[midiStep ] ] 
#turn off the note you are about to play 
if lastChan[midiStep] != -1: 
midiout.send message([@x9@ | lastChan[ 
midiStep], lastNote[midiStep],0]) 


if not mute[tileNumber |: 
midiout.send_message([@x90 + 
chan[tileNumber |-1,note[tileNumber ], velocity|[ 
tileNumber ] |) 
lastNote[midiStep |= note[tileNumber | 
lastChan[midiStep ]= chan[tileNumber ]|-1 
nextStep = time.time() + stepTime 
updateSamples(midiStep) 
midiStep += 1 
if midiStep >= samples: 
midiStep =0 


def allOff(): 
for i in range(@,16): 
midiout.send message([@xB@ | i,120,0]) 
# normally only one is needed 
midiout.send message([@xB@ | i,123,0]) 


def sensorScan(): 


global step,currentMotor, newScan 
alloff() # turn off any sound 
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A Figure 2 How to 


tidy up the colour 
sensor's wire 


TopTip @& 


Aligning 
Si-clops 


We drew a white 
square round 

the end of the 
sample tile holder 
to allow us to set 
Si-clops in exactly 
the right place. 

If you shade 
external light 

with your hand, 
you can see the 
illuminated area 
the colour sensor 
uses to detect 
the colour. 


> Figure 3 The 


sequencer 
control panel 


i 


Figure 2 


found last month, the optimum distance for working 
with the colour sensor is 10mm, so the Si-clops is 
designed to get as close as possible to this distance. 


The practice 

The construction of the Si-clops is simple 
enough, and could be guessed from the pictures 
we show here. However, a step-by-step guide 
to building Si-clops is on the GitHub page 
(magpi.cc/dhaAam). All the parts are from the 
Boost set, so you’ll have them to hand. However, the 
Studio modelling program does not handle flexible 
parts, so Figure 2 shows you how to wrap the cable 
from the colour sensor to Port C of the Boost Hub. 
It’s best to plug the colour sensor’s wire into the 
Hub and then temporarily remove the Lego brackets 
and push the cable behind and then replace them. 


What the code needs to do 


We need the Python controlling code to 
instruct the Boost’s Hub to move the two built-in 
motors through eight short steps, stopping at the 
end of each step to send back a colour sample. This 
sampling can be controlled through an on-screen 
button or by pushing the Hub’s green button. Then 
this sequence is displayed and a click of the Run 
button starts things going. The exact note pitches, 
velocities, and channel/instrument are controlled 
by mouse clicks, as are the tempo and the channel 
mute. The code is written under the Pygame 
framework and is shown in the Si-clops.py listing. 


Icons 
The program needs a directory called icons; 
in it, there needs to be two 15x15 pixel images ona 


48 | magpi.cc | Hack Lego Boost with Raspberry Pi 


transparent background, called 0.png and 1.png. 
The 0.png image is a green plus sign, and the 1.png 
image is ared minus sign; both can be made with 
any paint package, such as GIMP. Figure 3 shows 
the layout of the screen; the whole user interface 

is based on Pygame’s rectangle data structure, 
rect. Rectangles are defined for each user control, 
and the mouse down and up events change the 
appropriate numbers. This results in easy-to- 
modify, efficient code. 


Code in depth 


The insNums list holds the instrument 
number associated with each MIDI channel, with 
the instNames list showing the names. You can 
change these if you would like to use a different 
set of instruments. Each instrument potentially 
sounds for the full length of the sequence, the 
note-off message only being sent just before the 
note-on message. If a colour appears more than 
once in the sequence, then the note-off message is 
sent whenever that colour is encountered. A brown 
square in the middle of a sample colour indicates 
that it is the one currently being played. 


Customising the code 

All GUI colours are defined by variables, so 
they are easy to change. The motor moves by the 
number of degrees defined by the inc variable in 
the incMotor function for each step. The original 
code is set so that Si-clops moves 20 mm per step; 
you can change this to whatever you want if you 
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Si- 


992. 
993. 
994. 
995. 
096. 
097. 
098. 
999. 


100. 
LOL. 
102. 
163. 
104. 
105. 


106. 
107. 
108. 
169. 
110. 
111. 
112. 
113% 
114. 
115. 
116. 
117. 
118. 
119; 
126. 
121. 
122; 
423. 
124. 
125. 
126. 


127. 
128. 
429, 
130. 


131. 


132. 
133% 
134. 


135. 
136. 
137. 
138. 
139. 
140. 


clops.py (continued) 


for i in range(@,samples): 
scannedBlock[i] = 1 # background colour 
incMotor() # to move before first sample 
step = 0 
while step < samples: 
checkForEvent() 
getCol() 
movehub.motor_AB.angled(-currentMotor, 
back to start 
newScan = False 
updateValues() 
step = 8 3 currentMotor = @ 


4) # 


def getCol(): 
global lastColour, updateColour, motorUpdate, 
scannedBlock, shutDown 
if updateColour >= 2 and motorUpdate: 
# put in the index of the colour 
scannedBlock[step] = correctColour(lastColour) 
updateSamples(-1) 
updateColour = @ 
motorUpdate = True 
incMotor() 
else: 
updateColour = 


I 
© 


def initMIDI(): 
global midiout 
available ports = midiout.get ports() 
print("MIDI ports available:-") 
for i in range(@,len(available ports)): 
print(i,available_ports[i]) 
if available ports: 
try: 
midiout.open_port(1) 
except: 
print( 
"No MIDI port found opening virtual port") 
midiout.open_port(@) 
for ch in range(@,16): # set up channels 
if ch t= Go: 
midiout.send message([@xC@|ch, insNums[ch]]) 
# set instrument 
midiout.send message([@xB@ | ch,0x@7,127]) 
# set volume 
setTime() 


def setTime(): # calculates the step time from the 
tempo (BPM) 
global stepTime, tempo 


stepTime = 1/(tempo / 62) 
updateValues() 
def init(): 


global motor, markerRect, shutDown, driveRect, 
incRect, decRect, icon, decRect, muteRect, 
voiceRect, sampleRect, rsRect 
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motor = None 
movehub. button. subscribe(call_ button) 
movehub.color_distance_sensor.subscribe( 
callback_colour, granularity=0) 
icon = [pygame. image. load( 
“icons/"+str(i)+".png").convert_alpha() 
for i in range(@,2) | 
incRect = [pygame.Rect((@,0),(15,15))]*20 
decRect = [pygame.Rect((0,0),(15,15)) ]*20 
for j in range(@,3): 
for i in range(@,6): 
incRect[i+j*6] = pygame.Rect(( 
76 + j*80,76+i*40),(15,15)) 
decRect[i+j*6] = pygame.Rect(( 
76 + j*80,96+i*40),(15,15)) 
incRect[18] = pygame.Rect((76,326),(15,15)) 
decRect[18] = pygame.Rect((76, 346), (15,15) ) 
incRect[19] = pygame.Rect( (116, 326), (15,15) ) 
decRect[19] = pygame.Rect((116,346),(15,15)) 
driveRect = pygame.Rect( (176, 335), (54, 22)) 
rsRect = pygame.Rect( (296, 335), (38,22)) 
muteRect = [pygame.Rect((0,0),(15,15))]*6 
voiceRect = [pygame.Rect((@,@),(15,15))]*6 
for i in range(@,6): 
muteRect[i] = pygame.Rect((370,80+i*40), 
(28,20)) 
voiceRect[i] =pygame.Rect((268,85+i*40@), 
(100, 20)) 
sampleRect = [pygame.Rect((0,0),(15,15))]*8 
for i in range(@,samples): 
sampleRect[i] = pygame.Rect((58+1i*40, 20), 
(20,20)) 
markerRect = [pygame.Rect((0,0),(15,15))]*8 
for i in range(@,samples): 
markerRect[i] = pygame.Rect((63+i*4@,25), 
(10,10)) 
setTime() # calculate MIDI time interval 


def drawScreen(): 
screen. fill (backCol) 
for i in range(@,20): # increment / decrement 
icons 
screen. blit(icon[®@], ( 
incRect[i].left,incRect[i].top) ) 
pygame.draw.rect (screen, lineCol, incRect[i],1) 
screen. blit(icon[1], ( 
decRect[i].left,decRect[i].top)) 
pygame.draw.rect (screen, lineCol,decRect[i],1) 


# draw all tiles 

playingToLego = [3,6,7,9,10,@] 

for i in range(@,6): 

pygame.draw.rect (screen, 

tileColours[playingToLego[i]], (10,82+40*1, 20,20) ,@) 

drawWords("Tile",10,54,(@,0,@), backCol) 

drawWords("Channel",58,54,(@,0,0), backCol) 

drawWords("Note",138,54,(@,8,0), backCol) 
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| 360.00 Figure 4 


A Figure 4 Sample 
holder and tiles - 
dimensions in mm 


> Figure 5 Si-clops 
and a loaded 
sample holder 


7. 
ol 
al 


want to roam over artwork. Si-clops also returns 
to its starting position after the sample scan, but 
you could change that also. By moving the two 
Hub motors by different angles each step, you can 
get Si-clops to move in a curve as opposed to a 
Straight line. 


07 Tile sample holder 

While running Si-clops over artwork can be 
fun, it can also be a bit hit and miss. If you want to 
explore sequences with absolute control, you need 
a colour sequence you can set up as you want. So we 
made a sample holder, which is basically just a piece 
of 1mm (or thicker) mounting board, cut out in the 
dimensions shown in Figure 4. A slot is cut out at 


Figure 5 
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Installing rtmidi 


If you haven't got the Python MIDI library installed, 
open up a Terminal and enter: 


sudo apt-get install libjacke 

sudo apt-get install libjack-dev 
sudo apt-get install build-essential 
sudo apt-get install libasound2-dev 
sudo pip3 install python-rtmidi 


one side, and we painted round the slot with brown 
paint. We cut out small pieces of card that will slide 
along the slot and painted them different colours. 
Fixing the sample holder to the desk with very small 
pieces of Blu Tack stopped it moving. 


Painting 

We used low-cost acrylic paints from an art 
shop to paint our tiles; there is a 4mm strip down 
the edge of the tile and we painted it brown. We 
found that brown was a good neutral colour that did 
not affect the detection of adjacent colours. Then we 
painted the main colour in the rest of the tile. For 
a full set of tiles you need eight of each colour, but 
Six is enough in practice. Also, the mounting board 
we used had a black back, so there is no need to 
make any black tiles — just simply turn any tile over. 
Figure 5 shows the finished assembly. 


In conclusion 

Well, that wraps it up for our experiments with the 
Lego Boost set. We hope you have enjoyed it. But 
we have hardly scratched the surface — we certainly 
could write a whole book on the topic. Hopefully, 
we have inspired you to make your own creations 
and we would love to see what you have made with 
this set. We might revisit this set sometime in the 
future, though, for some more fun. {I 


Disclaimer 


LEGO® is a trademark of the LEGO Group of 
companies, which does not sponsor, authorise, or 
endorse this article. 
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drawWords("Velocity",218,54,(@,8,@), backCol) 
drawWords("Voice",285,54,(@,0,0), backCol) 
drawWords( "Mute", 370,54, (@,8,@), backCol) 
drawwords("Tempo",10,324,(0,0,@), backCol) 
drawWords("X10",112,366,(@,0,@), backCol) 
drawWords( "BPM" ,40,366,(0,8,0), backCol) 
drawWords("Sample",180,340,(@,0,0), backCol) 
pygame.draw.rect(screen, lineCol,driveRect, 1) 
updateValues() 

updateSamples(-1) 


def updateSamples(point): 
for i in range(@,samples): # draw sample 
sequence 
pygame.draw.rect(screen, tileColours 
[scannedBlock[i]], sampleRect[i],®) 
pygame.draw.rect(screen, (200,128,0), 
sampleRect[i],1) # outline 
if point != -1: 
pygame.draw.rect(screen, (200,128,080), 
markerRect[ point], 0) 
pygame.display.update() 


def nameNote(index): 
noteNumber = note[ index ] 
octave = (noteNumber // 12) - 5 
noteInOct = noteNumber % 12 
return str(octave)+" “+noteNames[noteInOct]+" ° 
def updateValues(): 
for i in range(@,6): 
drawwords(str(chan[i])+" 
(@,8,8), backCol) 
if chan[i] != 10: 
drawWords(nameNote(i),112,85+1i*40, (0,0,0), 


" 48, 85+i*40, 


backCol ) 
else: 
drawWords(" “+str(note[i])+" 
"112,85+i*40,(0,0,0), backCol) 
drawwords(str(velocity[i])+" 
" 204,85+i*40,(0,0,0@), backCol) 
pygame.draw.rect(screen, backCol, 
voiceRect[i],®) 
drawWords(str(instNames [ 
chan[i]-1]),270,85+i*40,(@,0,0), backCol) 
pygame.draw.rect(screen, backCol, muteRect[i], 0) 
pygame.draw.rect(screen, lineCol, muteRect[i],1) 
if mute[i]: 
pygame.draw.rect(screen, backCol,muteRect 
[i],®) 
drawWords("Mute",370,85+1i*40, (0,0,0), 
backCol) 
drawWords(str(tempo)+" 
backCol) 
pygame.draw.rect (screen, backCol,rsRect, @) 
if running: 
drawwords("Stop", 300, 340,(0,0,8), backCol) 


",10,366,(0,0,0), 
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else: 
drawWords("Run ",300,340,(@,0,0), backCol) 
pygame.draw.rect (screen, lineCol,rsRect,1) 
if not newScan: 
pygame.draw.rect(screen, backCol,driveRect,®) 
pygame.draw.rect(screen, lineCol,driveRect,1) 
drawWords("Sample",180,340,(@,0,0), backCol) 
pygame.display.update() 


def drawWords(words,x,y,col,backCol) : 
textSurface = font.render(words, True, col, 
backCol ) 
textRect = textSurface.get rect() 
textRect.left = x # right for align right 
textRect.top = y 
screen.blit(textSurface, textRect) 
return textRect 


def callback_colour(colour, distance): 
global lastColour, updateColour, tileDistance 
lastColour = colour 
tileDistance = distance 
updateColour += 1 


def correctColour(colour): 
if colour > 10: # to correct for not a colour 


colour = @ 
correctColour = colour 
if colour == 5: # to correct for green error in 
sensor 


correctColour = 6 
return correctColour 


def incMotor(): 
global currentMotor, motorUpdate, updateColour, 
step 
inc = 76.39 
currentMotor += inc 
movehub.motor_AB.angled(inc, .4) 
step += 1 # number of steps taken 


def handleMouse(pos): # look at mouse down 

global pramClick, pramInc 

#print(pos) 

if driveRect.collidepoint(pos): 
pygame.draw.rect(screen,hiCol, driveRect, @) 
pygame.display.update() 

if rsRect.collidepoint(pos): 
pygame.draw.rect(screen,hiCol,rsRect, @) 
pygame.display.update() 

for i in range(@,6): 

if muteRect[i].collidepoint(pos): 

pygame.draw.rect(screen,hiCol,muteRect[i],®) 
pygame.display.update() 


pramClick = -1 
pramInc = @ 
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Si-clops (continued) 
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for i in range(@,2@): 
if incRect[i].collidepoint(pos): 
pramClick = 1 
pramInc = 1 
pygame.draw.rect(screen,hicol, 
incRect[pramClick],1) 
pygame.display.update() 
for i in range(@,2@): 
if decRect[i].collidepoint(pos): 
pramClick = 1 
pramInc = -1 
pygame.draw.rect(screen,hicol, 
decRect[pramClick],1) 
pygame.display.update() 
if pramClick == 19: # for tempo X10 
praminc = pramInc * 10 


def handleMouseUp(pos): # look at mouse up 
global mute, velocity, note, chan, tempo, 
running, newScan, midiStep, lastChan 
if rsRect.collidepoint(pos): 
running = not running 
if not running: 
allOfF() 
midiStep = 0 
else: 
for i in range(@, samples): 
lastChan[i]=-1 
updateValues() 
updateSamples(-1) 
if driveRect.collidepoint (pos): 
newScan = True 
updateValues() 


if pramClick != -1: 
if pramClick < 6: 
chan[pramClick] += pramInc 
chan[pramClick] = 
constrain(chan[ pramClick],1,16) 
elif pramClick < 12: 
note[pramClick-6] += pramInc 
note[pramClick-6] = constrain(note[ 
pramClick-6],15,127) 
elif pramClick < 18: 
velocity[ pramClick-12] += pramInc 
velocity[pramClick-12] = constrain(velocity[ 
pramClick-12],0,127) 
elif pramClick >= 18: 
tempo += pramInc 
tempo = constrain(tempo, 30,80) 
setTime() 
if pramInc !=0: 
if pramInc < @: 
screen. blit(icon[1], ( 
decRect[pramClick].left,decRect[pramClick].top) ) 


52 | magpi.cc | Hack Lego Boost with Raspberry Pi 


348. 
341. 
342. 
343. 
344. 
345. 


346. 
347. 
348. 
349. 
358. 
351. 
3525 
553% 
354. 
355. 
356. 
357. 
356. 
359. 


360. 
361. 
362. 
363. 
364. 
365. 
366. 
367. 
368. 
369. 
378. 
371. 
372i 
373. 
374. 
3/5 
376. 
377. 
378. 
379. 
380. 
381. 


pygame.draw.rect(screen, lineCol, 
decRect[ pramClick],1) 
else: 
screen.blit(icon[0], (incRect[ 
pramClick].left,incRect[pramClick].top) ) 
pygame.draw.rect(screen, lineCol, 
incRect [pramClick],1) 
updateValues () 
for i in range(@,6): 
if muteRect[i].collidepoint(pos): 
mute[i] = not mute[i] 
updateValues() 


def constrain(val, min_val, max_val): 
return min(max_val, max(min_val, val)) 


def call _button(is_pressed): # scan on hub 
button press 
global newScan 
if not is_ pressed : 
newScan = True 


pygame.draw.rect (screen, hiCol,driveRect, 0) 


pygame.display.update() 
time.sleep(1.0) 


def terminate(): # close down the program 
global midiout 
print ("Closing down") 
alloff() 
movehub. button. unsubscribe(call_button) 


movehub.color_distance_sensor.unsubscribe( 


callback _colour) 
conn.disconnect() 
del midiout 
pygame.quit() # close pygame 
os. exit(1) 


def checkForEvent(): # see if we need to quit 


global shutDown, newScan 
event = pygame.event.poll() 
if event.type == pygame.QUIT : 
terminate() 
if event.type == pygame.KEYDOWN : 
if event.key == pygame.K_ESCAPE : 
terminate() 
if event.key == pygame.K_SPACE : 
newScan = True 


if event.type == pygame.MOUSEBUTTONDOWN : 


handleMouse(pygame.mouse.get_pos()) 
if event.type == pygame.MOUSEBUTTONUP : 


handleMouseUp(pygame.mouse.get_pos()) 


Use your Pi to collect 
sensor data to the 
Google Cloud 


UrsaLeo 


Download our Raspbian package to 
turn your Pi into a Google cloud 
gateway. Display data on dashboards, = 


store and download it, use it to drive 


emails, texts and other alerts. 


| : LEDs indicate BLE, internet and 
Enter code | magpil cloud connectivity 


at account creation to receive Console interface 


a free Pi debug board” Safe power down switch 


ursaleo.com/raspbian 


: : Google loud Platform 
*Offer available for North America and Europe only «> Et 
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PJ is a writer, 
Raspberry Jammer, 
and developer. He 
solemnly swears he 
is up to no good. 


@mrpjevans 


You'll Need 


>» At least two rooms 


> One Pi Zero W 
per room 


> One or more willing 
participants 


> One beacon per 
participant, e.g. 
magpi.cc/iGmnAa 


Make a 


Marauders Map 


Make your own Marauder's Map and track your family, pets, 
Gnd friends (or enemies?) using Bluetooth beacons 


n the Harry Potter series, the Marauder’s 
Map showed you the location of every 

person in Hogwarts. That map worked with 
magic, but ours will work with Raspberry Pi and 
beacons. Bluetooth beacons are low-energy 
devices that constantly ping out a signal that can 
be read by any device. Typically, they are used 
by museums or supermarkets in conjunction 
with a smartphone app to detect where visitors 
are and offer relevant information. We’re going 
to flip this and have people carry the beacons 
with them. Raspberry Pi devices in each room 
will detect someone’s presence and update a 
web-based map. 


Pi Zero W devices are perfect 
for this project, their on-board 
Bluetooth detecting the beacons 
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Get some beacons 

Bluetooth Low Energy (BLE) beacons are 
simple devices that send out a constant signal in 
the form of a unique code or URL. Bluetooth 4.0 
capable devices can detect this signal without 
needing to pair. There are a few different standards 
and our project is going to support the two most 
popular: iBeacon (Apple) and Eddystone (Google). 
These types of beacons are easily found online 
and tend to be small button-sized devices capable 
of running for up to a year on a single battery. 
Alternatively, software is available so you can use 
Raspberry Pi boards and microcontrollers (e.g. 
ESP32) so they act as beacons. 


Beacons come in all shapes 
and sizes. You can even turn 
Raspberry Pi boards and 
microcontrollers into beacons 


Prepare your Pi devices 

Each person is going to carry a beacon 
with them. As they move from room to room, a Pi 
Zero W in each room will detect the presence of the 
beacon and report it back to a designated server 
(which can be one of the Pi devices). Set up each Pi 
with Raspbian Stretch Lite, get them on the WiFi 
network, then update the software: 


sudo apt update && sudo apt -y upgrade 
We need to install a few libraries: 


sudo apt install python3-pip libbluetooth-dev 
sudo pip3 install beacontools[ scan] 


Now we can scan for beacons in Python. 


M Each scanner is going to 
report Its findings back to a 
central server @ 


Get the beacon IDs 

Each beacon has either a unique ID code 
(iBeacon) or broadcasts a web address (Eddystone). 
If you’re using iBeacons and the vendor hasn’t 
supplied the ID, you’1l need to discover it by 
scanning. Create a file containing the code from 
the test.py listing. Save it as test.py and run 
as follows: 


sudo python3 test.py 


All being well, you’ ll see your beacon’s 
transmissions. Make a note of the 32-character 
string just after ‘uuid’. Repeat for each one. 

For Eddystones, instructions will be provided 
on how to set the web address. Set each one to 
http://example.org/name, where ‘name’ is the 
person’s first name. 


Install the server software 

Each scanner is going to report its findings 
back to acentral server. Pick one of the Pi 
devices for this role, then download the code from 
magpi.cc/Hjhtwi to a directory in your home folder 
called beaconmap. First, install Flask: 


pip3 install flask 


The 
PI-RAUDER’S 
MAP 
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Then test the server by running: 
python3 ~/beaconmap/server/server. py 


If you’re on the same machine, open 
http://127.0.0.1:5000 in a browser; otherwise 
you’ll need to replace 127.0.0.1 with the IP address 
or host name of the server. You’1l see a very boring 
webpage asking ‘Where is everyone°’. CTRL+C will 
stop the server. 


Install the scanners 

On each Raspberry Pi, create a file called 
scanner.py and enter the code from the listing 
here. If you don’t fancy typing, install the software 
package from magpi.cc/Hjhtwi and you’!1 find it in 
the scanner directory. 

The code uses Citruz’s BeaconTools library to 
scan the area for beacon signals in bursts of ten 
seconds. When this happens, the code notes 
the ID/URL provided and gives it a score of one, 
with subsequent transmissions incrementing 
the score. After ten seconds, the scores are sent 


A Our final web app 
updates as people 
move around the 
house. There's lots 
of scope for getting 
creative here 


TopTip @& 


Signal 
strengths 


To avoid all the 
scanners seeing 
your beacon, 
put it on a low 
power setting 

if available. 
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A With its small size 
and smart casing, the 
Raspberry Pi Zero W 
makes a tasteful 
addition to any room 


TopTip @& 


Beacon types 


There are many 
different beacon 
standards; make 
sure you're 
using iBeacon 
or Eddystone for 
this project. 


to the server. The server can compare scores for 
different scanners to work out where someone is, 
eliminating overlapping areas. 


Configure and test the server 

IDs aren’t very useful, so configure the 
server by editing the beacons dictionary. Replace 
each key with a beacon ID and set the value to 
{‘name’: ‘name’ }. (There are more instructions 
in the code.) Add as many as you like. When the 
reports come in from the scanners, we will now 
know who they are! 

You should have something like this: 


beacons = { 
"b63cc056-6f3a-4a9b-80bf-11FF1c6FF724': { 


"name': ‘PJ Evans' 

}s 

"144dd069-e22e-418f -b940-c622d64b7252': { 
"name': ‘Jazz The Cat' 

ii 


Test the server by starting it as before. If you’ve 
made any typos in the beacon list, you’ll find out 
now. Leave it running. 


07 Configure and 
start your scanners 
Edit scanner.py and replace the value of serverUr1 
with the address of your server. Make sure 
‘/readings’ remains at the end. Then edit room to be 
the Pi’s room or location name. 
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On each scanning Raspberry Pi, enter the 
following command: 


sudo python3 ~/beaconmap/scanner/scanner.py 


Each scanner will scan for ten seconds and then 
report scores back to the server. Check that traffic 
is flowing correctly. The server will echo incoming 
data on-screen. If things are not working, check if 
the server is running a firewall; it needs to allow 
traffic in through port 5000. 


Get tracking 

With scanner.py running on each Pi and 
the server up, take one of your beacons and place 
it next to one of the scanning Raspberry Pi devices. 
After ten seconds, refresh the webpage. Your 
beacon should have been matched and the location 
displayed. Repeat with another Pi. Check the page 
again. Did it move? 

If you get confusing results, the Raspberry Pi 
boards may be too close to each other (Bluetooth 
goes through walls!), causing an overlap. If you can 
set the beacon’s power output, it should be as low 
as possible; this increases battery life and accuracy. 


Get creative 

So far, so good, but it’s all a bit boring 
on the webpage. Grab your crayons and design 
a map. We’re not using any kind of positioning 
technology, so you can have fun and not worry 
about accuracy. Make sure it’s nice and big as an 
image (try around 1000x1000 pixels) and save as 
beaconmaps/servermap/static/rooms.png. 

You’ ll also need some avatars, so grab a selfie 

or screenshot your favourite meme, and create a 
Square image 75*75 for each person and Save in 
the same directory in the format name. jpg so it 
matches the names in the server configuration. 


Run the advanced server 

We’ ve provided a fancier web server 

using Flask, to make the map a bit more fun. 
Stop the standard server (CTRL+C), configure the 
server.py file in servermap as before, then run 
the following command: 


python3 beaconmap/servermap/server .py 


Give the scanners time to report in and have 

a look at the page. It will probably be a bit of a 
mess, but you can have a look at the code for 
instructions on how to adjust things so your 
avatars appear in the right places. Make sure 
everyone is appearing in the correct location, then 
stop the server and scanners. 


M Make sure everything 
Starts on boot, then runs in 
the background & 


Automate all the things 

The final step is to make sure everything 
starts on boot, then runs in the background so 
you don’t need to have a Terminal open all the 
time. There are many methods, but the easiest 
way to do this is to edit the rc.local file and add 
our requirements. 


sudo nano /etc/rc.local 


Before the last line that reads exit @, insert anew 
line and add the following lines. 
For the server: 


/usr/bin/python3 /home/pi/beaconmap/servermap/ 
server.py & 


For each scanner: 


/usr/bin/python3 /home/pi/beaconmap/scanner/ 
scanner.py & 


To test, reboot each device. Everything should now 
run in the background. 


More with beacons 

Now let your imagination get involved. 
What else can you do with these beacons? Try 
modifying the server to alert your smartphone 
when someone arrives in a certain place. Or how 
about a digital Easter egg hunt? Give everyone a 
battery-powered Pi Zero W and hide beacons. Your 
score could be generated automatically as you find 
them. Could you make a box that only opens when 
someone carrying the right beacon approaches? 
Over to you. 


DOWNLOAD 
scanner.py THE FULL CODE: 
>» Language: Python 3 


001. 
002. 
003. 
004. 
905. 
006. 
007. 
008. 
909. 
010. 
Q11. 
912. 
913. 
014. 
Q15. 
016. 
Q17. 
018. 
919. 
920. 
Q21. 
O22. 
923. 
Q24. 
Q25. 
Q26. 
Q27. 
Q28. 
Q29. 
930. 
Q31. 
Q32. 
Q33. 
934. 
935. 
036. 
Q37. 
038. 
Q39. 
040. 
041. 
042. 
043. 
044. 
Q45. 
046. 
047. 
048. 
049. 
Q50. 
Q51. 
Q52. 


TUTORIAL | MagPi SS 


© magpi.cc/Hjhtwi 


import time 
import requests 
from beacontools import BeaconScanner 


serverUrl = "http://127.0.0.1:5000/readings" 


room = "Kitchen" 
beacons = {} 


# This function is called whenever a packet is detected 
def callback(bt_addr, rssi, packet, additional_info): 


# Parse out the type of beacon 
typeOfBeacon = type(packet).__name__.split(".").pop() 


# Get the ID of the beacon 


if typeOfBeacon == "EddystoneURLFrame": 
beaconId = packet.url 
elif typeOfBeacon == "IBeaconAdvertisement": 


beaconId = packet.uuid 


# Track how many times we've seen this beacon 
if beaconId not in beacons: 

beacons[beaconId] = 1 
else: 

beacons[beaconId] += 1 


# Scan for all advertisements from beacons 
print('Starting beacon scanner’ ) 

scanner = BeaconScanner(callback) 

scanner. start() 


while True: 


# Allow a 1@-second sample to come through 
print('Waiting 10 seconds') 
time.sleep(12) 


# Now send the current scores to the server 
print( "Sending to server") 
try: 
response = requests.put(serverUrl, json={"room': room, 
"beacons": beacons}) 
if response.status code == 200: 
print('Success' ) 
else: 
print('Got response code: 


+ str(response.status_ code) ) 
except: 
print("Communication error") 


# Clean the scores 
beacons = {} 


Make a Marauder’s Map | magpi.cc | 57 


TI MagPi | TUTORIAL 


Simon Long 

is a software 
engineer working 
for Raspberry Pi, 
responsible for 
the Raspberry 

Pi Desktop on 
both Raspbian 
and Debian. 


rpf.io 


Buttons and labels 


with C and GTK 


Make your empty window more interesting and 
interactive by adding a button and text label 


he simple program we looked at in last 
issue’s instalment (magpi.cc/81) draws a 
window on the screen, but it looks rather 
bare. There’s also that problem that closing the 
window with the X button leaves the program still 
running. We’re going to fix both of those by adding 
a button to close the window. 

A button is another standard GTK widget, and 
it supports all the features you’d expect — you can 
have a label on it; you can see its appearance change 
when you click it; you can activate it with a keyboard 
shortcut; you can even disable it temporarily and 
erey it out. 

The first thing to do is to add the button to the 
window. When we’ve done that, we can look at 
making it do something useful. Modify the code for 
the previous example as follows: 


#include <gtk/gtk.h> 


void main (int argc, char *argv[]) 
{ 
gtk_init (&argc, &argv); 
GtkWidget *win = gtk_window_new 


An Introduction 


toC & GUI | 
Programming 


AN INTRODUCTION 7 


C:sGul 
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For further tutorials on how to start coding 
in C and creating GUIs with GTK, take a 
look at our new book, An Introduction to 

C & GUI Programming. Its 156 pages are 
packed with all the information you need 
to get started - no previous experience of 
C or GTK is required! 

magpi.cc/GUIbook 


PROGRAMMING 


Simon Long 


A Figure 1 The window with a button on it 


(GTK_WINDOW_TOPLEVEL) ; 


Let’s look at the changes: 


GtkWidget *btn = gtk_button_new_with_label 
("Close window") ; 


This creates a GtkButton widget. There is a standard 
gtk_button_new function, but using this version, 
gtk_button_new_with_label, allows us to add a text 
label to the button at the same time as we create it. 


gtk_container_add (GTK_CONTAINER (win), btn); 


The gtk_container_add function places the button 
inside the window. 


gtk_widget_show_all (win); 


Finally, the call to gtk_widget_show is now replaced 
with a call to gtk_widget_show_all — this tells 


GTK to show both the named widget and any 
widgets it contains. If this line wasn’t changed, 
the window would be shown, but the button would 
remain hidden. 

If you now build and run the code, you’ ll find that 
you get a (smaller) window with a button labelled 
‘Close window’ displayed on it (Figure 1). 


Containers 
In the example, we use the line: 


gtk_container_add (GTK_CONTAINER (win), btn); 


...to put the button into the window. 

As you’ve probably noticed, each function call 
in GTK starts with the prefix gtk_, which is then 
followed by the name of the widget type upon which 
it operates — So gtk_window_new creates a widget 
of type GtkWindow. This function call, therefore, 
operates on widgets of type GtkContainer, but we 
are using it on win, which is a GtkWindow. How does 
that work? 

There is a hierarchy of widget types within GTk, 
and a widget type inherits the properties of its 
parents within the hierarchy; that widget type can 
be described as a child of the widget types above it 
in the hierarchy. 


Mm Putting one widget 
Inside another like this is 
something we need to do 
quite often @ 


Because GtkContainer is one of the parents of 
GtkWindow, you can use gtk_container_ functions 
on GtkWindow widgets. Many widgets have 
GtkContainer as a parent, because putting one 
widget inside another like this is something we need 
to do quite often. 

You will notice that when win is supplied as an 
argument to the gtk_container_add function, it 
is wrapped inside the GTK_CONTAINER() function 
— this casts the argument to a variable of type 
GTK_CONTAINER; in other words, it tells the function 
call to treat this reference to a GtkWindow as 
a GtkContainer. The code will still work if this 
function isn’t included, but the compiler will 
complain! (GTK includes a GTK_ function for every 
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A Running the 
program from a 
Terminal to make 
the window appear 


type of widget, as it is quite common to need to cast 
a widget to a different type. ) 

So what this line does is to tell GTK to treat the 
GtkWindow widget win as a GtkContainer, and to 
put the button widget btn into it. 


Signals 
If you run the application, you can click the button 
with the mouse, and it will highlight to show that 
it has been clicked; you can also hit the ENTER key 
on the keyboard to do the same thing - this button 
behaves exactly like the buttons we are used to 
seeing in applications, but it still doesn’t actually do 
anything useful. The next step is to fix that. 
The way to do that is to connect a handler function 
to the signal generated when the button is clicked. 
Here’s the code with a handler added: 


#include <gtk/gtk.h> 


void main (int argc, char *argv[]) 
{ 
gtk_init (&argc, &argv); 
GtkWidget *win = gtk_window_new 
(GTK_WINDOW_TOPLEVEL) ; 
GtkWidget *btn = gtk_button_new_with_label 
("Close window") ; 
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> Figure 2 This time, 
when you click 
on the button, the 
window will close 


M All widgets 


Close wind Ne 


"clicked", 


CAl | ACK (end program), 


E NULL); 
gtk_widget_show_all (win); 
gtk_main (); 

} 


The handler function, otherwise known as a callback, 


is called end_program, and all it does is to call the 
GTK function gtk_main_quit — as you’d expect 
from the name, this function exits the loop within 
gtk_main and allows the program to end. 


g Signal connect (btn, "clicked", 
G CALLBACK (end_program), NULL); 


can generate signals under 


various circumstances - mostly when 
interacted with by the user @ 


This line connects the handler (end_program) to 
the signal called clicked, which is emitted bya 
button widget when the mouse is clicked on it. We 
use the GTK_CALLBACK function to make sure the 
compiler knows that the end_program function is a 
valid callback. 

Signals are used a lot in GTK; all widgets can 
generate signals under various circumstances — 
mostly when interacted with by the user, but also 
when certain system events occur. Each type of 
widget has a set of signals it can generate; the 
g signal connect function is used to ‘connect’ a 
handler function to them, meaning it will be called 
when the signal is generated. 

Handling signals is one of the most important 
jobs of the main loop which runs inside gtk_main — 
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gtk_container_add (GTK_CONTAINER (win), btn); 


if a signal is generated, code in the main loop checks 
to see if there is a handler associated with that 
signal, and calls the handler if so. 

Try building and running the new code. We 
now have a button on the window as before, but 
when we click the button, the window closes and, 
importantly, the program exits as well. 

This still isn’t perfect, though — if we click the X 
at the top right, the window closes (Figure 2) but 
the program doesn’t exit. Let’s fix that. 

The way we do this is to connect another 
handler to the signal generated when that X is 
clicked. The name of this signal is delete_event, 
and it is generated from the window widget. So we 
need to connect the same handler to that event 
as well: 


g signal_connect (win, "delete event", 
G CALLBACK (end_program), NULL); 


Note that we connect to win rather than to btn this 
time — the delete_event signal is created by the 
window widget rather than the button. Now if the 
window is closed by clicking the X, the delete_event 
signal causes the end_program handler to be called 
and the main loop then exits. 

We’ve now got a GIK application that opens and 
closes cleanly, but it still doesn’t do anything else. 
So in the next section, we’ll make it do something 
more useful... 


More advanced layout 

We’re going to add another button to the window, 
and display a count of the number of times the 
button is pressed. (All we said was that it would be 
more useful than the previous example; we didn’t 
say it would be useful for anything people might 
actually want to do!) 


Labels 

For displaying text on a window, we use a widget 
called a GtkLabel — a label is any piece of text which 
can’t be edited by the user. (The button we added 
in the previous example contains a label widget, 
which displays the name we gave the button in the 
gtk _button_new_with_label call.) 

You can create a label with text already in it, or 
you can create a blank label and add text to it later 
on; you can also change the existing text in a label 
whenever you like. 


Here’s the code to add a label to our window: 
#include <gtk/gtk.h> 


void end_program (GtkWidget *wid, gpointer ptr) 


{ 
gtk_main_quit (); 


void main (int argc, char *argv[ ]) 
{ 
gtk_init (&argc, &argv); 
GtkWidget *win = gtk_window_new 
(GTK_WINDOW_TOPLEVEL) ; 
GtkWidget *btn = gtk_button_new_with_label 
("Close window"); 
g signal connect (btn, "clicked", 
G CALLBACK (end_program), NULL); 
g signal connect (win, "delete event", 
G CALLBACK (end_program), NULL); 
gtk_container_add (GTK_CONTAINER (win), btn); 


gtk_widget_show_all (win); 
gtk_main (); 
ii 


Let’s look at the new code: 
GtkWidget *lbl = gtk _label_new ("My label"); 


This creates a GtkLabel called 1b1, with the text ‘My 
label’ in it. We then call another gtk_container_add 
to add the label to the window. Build and run the 
code, and see what happens. 

Ah. A window with a button, but no label. What’s 
gone wrong? Well, if you look at the Terminal 
window, you can get a clue — you should see an 
error message telling you that a GtkWindow can 
only contain one widget at a time, and that this one 
already contains a GtkButton. 

So you can only put one widget into a window, but 
we want to have two — a button and a label; that’s 
not going to work. Unless... 


Boxes 

A user interface toolkit that only allowed you to 
put one thing at a time on a window would be a 
bit limited! So while a window can only contain 
one widget, GTK offers several widgets which 

can be used to hold sets of other widgets. The 
two most useful ones are boxes and tables — we’|1 
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stick to boxes for the time being, as they are 
easier to use. 

There are two types of box widget, which are 
called GtkHBox and GtkVBox; these are short for 
‘horizontal box’ and ‘vertical box’, depending 
on how the widgets you put into the box are to 
be arranged. A box widget can hold an unlimited 
number of other widgets, but appears to its parent 
as a Single widget, so can be used to put multiple 
widgets into a window. 

We’re going to use a GtkVBox for this example, so 
modify the code as follows: 


TopTip @& 


Compiling and 
running 


For details of 
how to compile 
and run your C 
program using 
GTK, refer to 
part 1 of this 
guide, in issue 81 
(magpi.cc/ 81). 


#include <gtk/gtk.h> 


void end_program (GtkWidget *wid, gpointer ptr) 


{ 
gtk_main_quit (); 


void main (int argc, char *argv[]) 
{ 
gtk_init (&argc, &argv); 
GtkWidget *win = gtk_window_new 
(GTK_WINDOW_TOPLEVEL) ; 
GtkWidget *btn = gtk_button_new_with_label 
("Close window") ; 
g Signal connect (btn, "clicked", 
G CALLBACK (end_program), NULL); 
g Signal _connect (win, "delete event", 
G_ CALLBACK (end_program), NULL); 
GtkWidget *lbl = gtk_label_new ("My 
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My label 


Close window 
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<4. Figure 3 A GtkLabel 
and a GtkButton 
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> Figure 4 The button 
counting application 
before a button 
is pressed 


gtk_widget_show_all (win); 


gtk_main (); 
} 


Let’s look at the changes line-by-line: 
GtkWidget *box = gtk_vbox_new (FALSE, 5); 


This creates a new GtkVBox widget. The two 
parameters to the call are whether or not the 

box is homogeneous — which means it assigns 

the same amount of space to every widget it 
holds — and the spacing in pixels between the 
widgets it holds. So in this case, the box is not 
homogeneous ~ each widget will only be allocated 
as much space as it needs — and there will bea 
gap of 5 pixels between the two widgets we are 
putting into it. 


gtk_box_pack_start (GTK_BOX (box), lbl, 
TRUE, TRUE, @); 

gtk_box_pack_start (GTK_BOX (box), btn, 
TRUE, TRUE, @); 


The gtk_box_pack_start function puts a widget into 
a box. Widgets are added in the order that calls to 
this function are made, and the _start at the end 
indicates that widgets are placed in the box from 
the ‘start’ end, which is the top of a VBox or the 
left-hand side of an HBox. (There is also a 
gtk_box_pack_end function, which adds widgets 
from the bottom or right-hand sides.) 

The function takes five arguments; the first is the 
name of the box we are packing the widgets into, 
and the second is the widget we want to put into the 
box. The remaining three arguments control how 
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™ The window only holds one 
widget, the box, so won't 
compldin about holding too 
many widgets @ 


the widget is positioned in the box — we’ look at 
this later on. 


gtk_container_add (GTK_CONTAINER (win), box); 


Finally, we add the box to the window itself — this 
means the window only holds one widget, the box, 
so won’t complain about holding too many widgets. 

If you now build and run this, you should see a 
window like Figure 3 (previous page). 

Now we have a window containing the controls 
we need, let’s get back to creating our button push 
counter. Here’s the code: 


#include <gtk/gtk.h> 


void end_program (GtkWidget *wid, gpointer 
ptr) 
{ 
gtk_main_quit (); 
} 


void main (int argc, char *argv[]) 


{ 
gtk_init (&argc, &argv); 


GtkWidget *win = gtk_window_new 
(GTK_WINDOW_TOPLEVEL) ; 

GtkWidget *btn = gtk_button_new_with_label 
("Close window"); 

g Signal_connect (btn, "clicked", 
G CALLBACK (end_program), NULL); 


Figure 5 


| Close window | 


g Ssignal_connect (win, "delete event", 
G CALLBACK (end_program), NULL); 


GtkWidget *lbl = gtk_label_ new ("My 
label"); 


GtkWidget *box = gtk_vbox_new (FALSE, 5); 


gtk_box_pack_start (GTK_BOX (box), 1lbl, 
TRUE, TRUE, @); 

gtk_box_pack_start (GTK_BOX (box), btn, 
TRUE, TRUE, @); 

gtk_container_add (GTK_CONTAINER (win), 
box) ; 

gtk_widget_show_all (win); 

gtk_main (); 

} 


We’ve added a new button, btn2, along with a new 
handler callback function, count_button, which 
has been connected to the clicked signal on the 
new button. 


g Signal_connect (btn2, "clicked", 
G CALLBACK (count_button), lb1l); 


Note that whenever we have used g_signal_connect 
before, the last argument has been NULL, but 
in this case it is 1b1. The final argument of this 


Count button 
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Button pressed 3 times 


function is a pointer — it can be a pointer to 
anything which the handler might need to use. If 
you look at the arguments to the handler function, 
they are: 


void count_button (GtkWidget *wid, gpointer ptr) 


The first argument of a handler for any signal 

is a pointer to the widget that generated the 
signal. Different signals have different numbers 
of arguments in their handler functions, but 
they all have a general-purpose pointer as the 
last argument, and this receives the pointer 
that is supplied as the last argument to the 

g signal connect call. 

In this case, we need to update the text in the 
GtkLabel, so the handler needs access to a pointer 
to the label, and the general-purpose pointer is a 
convenient way of doing this. So we pass the 1b1 
pointer into g_signal_connect, and in the handler 
we cast this pointer back to a GtkLabel so we can 
use it in the gtk_label_set_text function, which 
updates the text in the label: 


gtk_label_ set_text (GTK_LABEL (ptr), buffer); 


Sometimes we need to pass more than one 
reference to something to a handler function, 
there are various ways around this like the use of 
structures or global variables, but for simple cases 
like this, the general-purpose pointer works well. 

If you now build and run the code, you should see 
a window which looks like Figure 4. 

When you click on ‘Count button’, the text in the 
label should update on each click (Figure 5). 
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Figure 5 After the 
‘Count button’ 
has been pressed 
three times 
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Want to power up your hobby trains? 
Let's go Pl-powered 
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e see so many hobbies making use of the 
W Raspberry Pi in amazing and novel ways. In 

many cases it makes a hobby more accessible 
(like robotics), or previously difficult tasks a little easier 
(such as advanced wearables). 

One of the oldest electronic hobbies around, model 
railways are intricate and beautiful miniaturised train 
services, long operated in garages and basements. Like 
anything, the technology in them has improved over the 
years, and many people have found ways to incorporate a 
Raspberry Pi into their track layout. So, let’s jump aboard 
and see what projects we can find! 
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Some great ways to get started with Pil-powered model railways 
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Connecting 


This control includes cars, accessories, and lighting 
— it’s pretty powerful! 
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JMR-PI | magpi.cc/puVuFE 

This is a Raspberry Pi port of JMRI, Java-based 
control software suitable for model railways. 
It’s described simply as a way of listening to 
and sending messages on the ‘command bus’. 
In conjunction with the software DecoderPro 
(magpi.cc/wRpmek), it can be used to control a 
model railway. 

JMR-Pi on a Raspberry Pi will work as a control 
box / headless server from which to connect to 
remotely — and thanks to its size, it hides a lot 
better in a railway than a spare computer. 


A With Rocrail, multiple user interfaces can be 
accessed from any web-connected device 
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dccpl | magpi.cc/ZFMZBJ 

A Python library specifically optimised for 
Raspberry Pi, it lets you work with the DCC 
protocol, which is used in the control of model 
railways. It’s a fairly simple library, able to 
control direction and speed, as well as some 
lights, over GPIO. It also requires a little power 
boost to make sure it provides a signal to the 
tracks, but it’s a fun, very DIY solution to 
controlling a train. It makes use of the WiringPi 
library, which could technically also be used on 
its own to control the railway, but dccpi is a lot 
more advanced. 


A& The Raspberry Pi needs an additional booster circuit, like 
this one, to actually provide the signal to the tracks 
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SPROG 

sprog-dcc.co.uk 

A HAT for the Raspberry Pi that turns it into a 
DCC interface. 


Digitrax decoder 
digitrax.com 

Digitrax makes a 
number of decoders that 
work on its LocoNet. 


Hornby Elite 
magpi.cc/mLFCkg 

A bit expensive, but it’s 
compatible with a lot of 
this software. 
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AMAZING MODEL 
RAILWAY PROJECTS 


Here are some incredible things people have done 
with gd model railway and a Raspberry P!! 


@, 
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Lionel Train Switch Control 
magpi.cc/yiLZhx 


Our friends at Dexter Industries put this 
guide together a while ago, showing you how 
to control switches in a model railway using 
a mixture of Arduino and Raspberry Pi. This 
uses a more direct method than DCC, as you’re 
controlling the power that activates the switches 
and stuff manually with power. 

While this is quite different to other methods, 
it’s an interesting way to program the setup, 
and allows you to use sensors hooked up to the 
Raspberry Pia little more easily for performing 
automation or adding your own manual buttons 
or controls. Perhaps you could 3D-print your own 
DCC-esque controller with this. 


A You'll need your relay 
to handle 20 V AC, so 
make sure to get the 
correct relay, and turn 
the power off before 
connecting it all 
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M The Internet of Lego Is a living project 
where | set out to learn everything 
about the Internet of Things @ 
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Internet of Lego 
internetoflego.com 


More than just a model railway, this is an entire 
Lego city, including railway, that is controlled 
by a mixture of Raspberry Pi and Arduino. We 
spoke to its creator, Cory Guynn, in issue 48 of 
The MagPi (magpi.cc/48). 

“The Internet of Lego is a living project where 
I set out to learn everything about the Internet of 
Things,” Cory told us back then. The train system 
is his favourite part, as he loves to see stuff in 
motion. There’s a train-scheduling system built 
upon the Transport for London API, showing the 
destination on an OLED screen and changing the 
tracks to match it. 

It makes use of WiFi, infrared, wired sensors, 


A Multiple Pi devices and Arduinos work in conjunction : 
to control the city and more to control not only the train and 


switches, but also the screens and other parts of 
the giant IoT Lego city. 
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M |t's a great way to learn about all the 
low-level electronics and code involved 
Ing pre-existing system @ 


Overview 


Learn all about Hall 
effect switches from 
Petter Wallen’s setup 


Raspberry Pi Model 
Railway Automation 


If you want to get into the real nitty-gritty of 
controlling your model railway, we recommend 
taking a look at Peter Wallen’s project. It makes 
use of the XPressNet protocol, which is one of the 
many ways you can control DCC devices. While the 
code is written in Python, it sends commands to 
the command line to activate specific addresses of 
things connected to the Pi, so it’s very low-level. 

It’s a great way to learn about all the low-level 
electronics and code involved in a pre-existing 
system, though, and there are some example 
Scripts available to help you get started 
integrating it into your own railway. 
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CDP Studio is a development platform for industrial control systems, now coming with a free 
version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, I2C and MQTT. Its built in GUI design tool 
and features lets you code less and do more. 


Free download on 


CDP Technologies AS Tel: +47 990 80 900 

Nedre Strandgate 29 info@cdptech.com 

P.O. Box 144 www.cdpstudio.com 

NO-6001 Alesund, Norway CDOPStudio 


SUBSCRIBE 


IN PRINT AND DIGITAL 
FIND US ONLINE: 


helloworld.cc 
@ @HelloWorld_Edu 
@) fb.com/HelloWorldEduMag 


ING 
wt MA AN KING EDUCATORS 


"INTERACTIVE 


Combining computer science & literacy 


THE MAGAZINE FOR COMPUTING 
& DIGITAL MAKING EDUCATORS 


COOLEST.» 
ERO EL 


a 
“atte eading te logy » ii 
ao INg peop! “ \ \ \ = 
SILICON VALLEY 2 “ 
Anitinerary for the ultimate x ' 
Computing school trip N ’ 4 
~ 4 ‘yy 
: Be 
Ss) [FP 
ea 


STS P™Puting Education HOMEWORK 


With the National Centre for Computing Educatio student _ et adhere . students aoe 

| * CARE WORKERS TEACH CODING « STA * CARE WOR 

* GETTING STARTED WITH THECRUMBLE « M momma Nt rool 
E 


AINGATUBRARig MUSEUMS 


The lights turn on and off in 
sections depending on the 
time of the day cycle 


FEATURE 


Wimborne Model Railway 


Model railways are more than just the locomotive 
making its way around — there’s also the miniature land 
set up around it! Wimborne Model Town in Dorset is home 
to a large model railway in a very intricate miniature town. 
All the houses have lights, and there several lamps and 
street lights in the model as well. 

A few years ago, a volunteer named Terry Coles at the 
model town upgraded the light system so it could be 
controlled via a Raspberry Pi. There are two sets of lights: 
the ones in the miniatures, and a big strip of LEDs that 
acts as a sun for the model railway. A day-night cycle 
exists in the model railway, with the LEDs lighting up the 
entire thing as if it was the middle of the day, before slowly 
turning off to represent a sunset. As this happens, lights 
in the model start turning on in sections, resulting ina 
dark night highlighted by the little lights of the model. 

It’s programmed in C and makes use of WiringPi. One of 
the cleverer parts of the project is having the OS load into 
memory so that when power is pulled from the Pi, it won’t 
have a chance to corrupt the SD card. 


MagPi 
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PiBug 2WD Robot 


> Atronix » magpi.cc/oUtoHY P» £24/5S31 


dual An easy-to-build, two-wheeled robot that uses the 
‘Yellow’ motors, Raspberry Pi gs part of its chassis 
1:48 ratio, 
nominally 
200rpm at 
6V, with JST he annual Pi Wars event always inspires Screw-together brass hex pillars are used as 
connectors T more people to get involved in robotics, but mounts for the two DC motors, creating a sturdy 
POWER: where’s the best place to start? Probably rectangular framework between them. One thing 
6 x AA batteries an inexpensive, entry-level kit like the PiBug. to note is that the 30 mm vertical pillars have 
(not supplied) What’s really clever about this two-wheeled robot slightly different ends, so you need to check that 
OPTIONAL is that your Raspberry Pi is used as a structural the rounded ones are on the bottom. 
SENSORS: component of the robot’s body, so you don’t need The other pillar ends are connected to two of 
necro llewar to buy or create a separate chassis. This makes the Raspberry Pi’s mounting holes using short 
board (2 x the robot much easier and quicker to get up and (9mm) pillars. The semicircular castor board is 
IR sensors), running, particularly as no soldering is required. then fitted under the front of the Pi, using more 
ultrasonic pillars. Note that if you want your robot to do 
HC-SRo4P “Idi : . 
Buggy building line-following, the standard castor board can 
Online step-by-step assembly instructions be replaced with one featuring two line sensors 
(magpi.cc/xDQQTw) show how to assemble all (available separately for £6). 
the parts to build your PiBug, which should take Next, the PiBug motor controller board is slotted 
around 30 minutes. onto the Pi’s GPIO header, then secured with more 


~ Allthe parts you 
need to build your 
PiBug robot - you 
just need to supply 
the Raspberry Pi 
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short pillars — onto which the battery holder board 
is mounted. The robot and Pi are both powered by 
six AA batteries; rechargeables are recommended. 
The final stage involves some simple 
connections. The motor wires have JST connectors 
that fit into slots on the motor controller board 
— much easier than screw terminals. If using line 
sensors, their female connectors slot onto pins 
at the rear of the motor controller board; this 
leaves six spare pins, connected to GPIO pins and 
power/ground, to use as you wish — along witha 
push-button on the board. An optional HC-SRo4P 
ultrasonic distance sensor (available for £2.22) is 


connected via four small holes in the battery board. 


In the driving seat 
With the PiBug robot assembled and wired, you 
can start playing with it! A flick of a switch on the 
side turns on the power to the robot and Raspberry 
Pi. Once booted up, you can start coding using the 
PiBug Python library, which comes with a trio of 
examples to get you started. 

As well as code to test the IR line-follower and 
ultrasonic distance sensors, if fitted, there’s a 


VES 


~~, = it 


~ —_ — ‘>. - 
saEniZel- 
: wT rh 5e 


M Your Raspberry Pl is used 
as gd structural component 
of the robot's body @ 


program that enables you to drive the PiBug around 
manually via key presses on a remote computer via 
an SSH connection. The robot is pretty nippy and 
agile, zipping along at pace and spinning on its two 
wheels to quickly change direction. Ours didn’t 
run in a perfectly straight line by default, but you 
could always alter the library code to calibrate the 
motors. The PiBug also struggled to set off from 

a Stationary position at the lower speed settings, 
although it worked fine at a lower speed after 
slowing down from a faster pace. The low position 
of the castor board also prevents it navigating 
major bumps in the terrain. 

Still, for an entry-level robot, it works well 
enough and is a lot of fun. Naturally, you can use 
the Python library to create your own code to make 
the PiBug move autonomously, using the optional 
sensors to avoid obstacles and/or follow lines. H 
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A Along with 


numerous hex 
pillars, the Raspberry 
Pi forms part of the 
robot's chassis 


Verdict 


While it’s a little 
more expensive 
than the CamJam 
Edukit #3, the use 
of the Raspberry 
Pi and hex pillars 
to form a chassis 
is ingenious and 
makes for a cool- 
looking buggy. 
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LibreELEC 9.0 Leila 


> LibreELEC >» libreelec.tv » Free 


dpcpceaaals The latest version of this ‘Kodi OS’ brings Kodi 18's star new feature: 


18 ‘Leia’ 
COMPATIBILITY: retro game emulators, Rob Zwetsloot sees if they're worth the fuss 
All Raspberry Pi 
versions 
e love testing out a new Kodi version 

INSTALLATION: W with new features here at The MagPi - 
ae the Raspberry Pi powers media centres 
burnable image the world over, and we like to see how much 

they improve. Kodi’s development is changing 
EMULATOR 


Slightly, so this may be the last time we make sure 
API: to do a review for a new numbered version, or in Julu uae 
Libretro ; me 
this case LibreELEC. 
IMAGE SIZE: LibreELEC 9.0 is the latest version of our 
123MB favourite HTPC OS for the Pi, built around the as pp 
newest Kodi 18. As well as the usual minor tweaks 
and bug fixes behind the scenes (including a 
nice little update to the settings layout), the real 
selling-point of the new Kodi is native support for 
retro game emulators. 


5. ABH5188 #4s(SESR8HH Tike 


Join the party 

For years now, you have been able to play games 
on Kodi. However, it was not something properly 
supported by Kodi itself — you just had to install 


A. Notallthe emulators run as well as we'd like - the homebrew Blade 
Buster was slugging on some, with washed out colours 


WV The familiar interface 


is still there 


the right add-ons and such. 

That’s all changed here, with a wide selection 
of popular console emulators and controller maps 
made available using Libretro, which is part of the 
core Kodi system. 


The tech is all there, and it’s all pretty old, so it 
should be a simple addition to Kodi and LibreELEC. 
Or at least you would think, especially going by the 
handy new Games item in the default menu. This 
menu lets you install any of 
these emulators, but that’s 
about it. Games can be 
launched by going into the 
file manager in settings and 


Verdict 


ae os The game 
ates finding your ROM, which is ArAulauon Sture 
quite awkward. generally works, 
TV shows Boe cae 
This is only temporary, but it’s not 
Music according to the dev team, properly baked 


TV 


Games 


Add-ons 


Videos 


Weather 


Play your personal games or download one of the many game add-ons from the official 


repository. 


Enter add-on browser Remove this main menu item 
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in yet. Still, if you 
just want to watch 
your videos or 
play music, there's 
nothing better. 


Cw 


with a game browser 
coming in the future. For 
now, though, all the rest of 
its media abilities work just 
as well as before — it just 
might be best to temper 
any expectations about the 
eame-playing aspects. HH] 
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S114.99 $109.99 
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10 Best 


Health 
projects 


Get gd clean bill of health with these 
Raspberry Pi projects 


ne of the things we love to see is amazing 

medical and health applications of the 

Raspberry Pi. In our experience, they’re usually 
some of the most impressive displays that we see at 
Maker Faires, Coolest Projects, and other events where 
folks are showing off amazing projects. Here are ten of 
the best to inspire you. Hl 


BOINC 


Distributed computing for science 


Lending spare CPU cycles to help cure diseases? Not as crazy as 
you might think: BOINC has been around for ages, and uses your 
idle CPU to help fold proteins or solve equations that can one day 
result in cures and treatments. 


> boinc.berkeley.edu 
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Patient monito a, 


Vital signs HAT 


This project uses the HealthyPi, a HAT for the Raspberry Pi that is 
specifically for medical applications. With it, you can create a full 
ECG which can measure heart rate, SpO2, respiration, temperature, 
and blood pressure. 


> magpi.cc/ikhuAK 


Heartfelt 


Heart monitoring 
through feet 


Preventative care can save 
the NHS a lot of money, and 
the Heartfelt monitor is able 
to detect the symptoms of an 
oncoming cardiovascular event 
from the feet of at-risk patients. When 

an issue is detected, a carer is notified, 

and a quick doctor's visit and medicine will 
mean the patient avoids a trip to the hospital. 


> hftech.org 


LIV P| 
Air pollution monitor NN 


Air quality is a big deal in Hong Kong, 
and this Pi-compatible device lets 
you know just how clean your air 

is. It's aimed towards businesses, 

but it's also very useful at home if 
your're living in the big city and have 
concerns over air pollution. 


> livpi.com 


Avery early but excellent Pi project, 
where a research scientist turned his 
Pi into an MRI analysis computer. The 
key trick to getting this to work was 
hardware-accelerated calculations, 
as it wouldn't be as well optimised 

in software. 


magpi.cc/SWxdSi 


Continuous glucose monitor 


C} : 


Not every part of medicine is 
glamorous. However, like this 
screening device, it can still save 
lives. The idea is that it’s very cheap 
and can be used in poor countries 
where the incidence of gastric 
adenocarcinoma is high. 


magpi.cc/przGLX 


A DIY solution to a normal continuous 
glucose monitor (CGM) that helped 
Dana Lewis perfectly control her insulin 
injections thanks to a bit of machine 
learning. The Pi itself controls the insulin 
pump using the data from the CGM. 


Magi 


A usually expensive piece of equipment that allows for timed, 
precise doses of drugs or chemicals from a syringe - whether 
for a patient with an IV, or a scientist running a long-term 
experiment. This version, powered by a Pi, is much cheaper. 


magpi.cc/wPGyPy 


diyps.org 


This is an incredibly fancy piece of medical tech - a DNA 
imager that uses a Raspberry Pi. It's quick, has modern 
tech conveniences such as a touchscreen, and is an 
all-in-one device. 


magpi.cc/WdpPNQ 


This project pairs the Pi with Bluetooth 
heartbeat sensors that are popular with 
gym equipment, enabling you to get 
more useful stats from a workout than 
your usual treadmill display. Daniel here 
has made data analysis very flexible with 
the code. 


magpi.cc/2kBjOaM 
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RESOURCES 


Learn artificial intelligence 


with Raspberry P1 


With these resources, your Pi can think for itself. PJ Evans gets (machine) learning 


Google 


Price: 
Free 


ai.google/education 


Machine Learning —S_— Cours os tica 5 7 Q Search 


Machine Learning Crash Course 


with TensorFlow APIs 


Google's fast-paced, practical introduction to machine learning 


A self-study guide for aspiring 
machine learning practitioners 


Google AI Education 


The Raspberry Pi is a powerful 
tool when it comes to artificial 
intelligence (AI) and machine 
learning (ML). Its processing 
capabilities, matched witha 


small form factor and low power 

requirements, make it a great 

choice for smart robotics and 

embedded projects. Google is 

a champion of the Pi’s place 

in the Al world, its AIY voice 

recognition system being given 

away with this very magazine 

(issue 57, no longer available 

in print - magpi.cc/57). 
Google’s AI Education site 

is an ideal place to start your 

machine-learning journey. If 

you want to really understand 

how AI/ML works ‘under the 

hood’, there are lot of principles 

to comprehend before you 


Lprooucts 3 re) 
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Essential websites 


Providers of popular AI/ML tools 


GOOGLE CORAL 

Recently featured in The MagPi #79, this 
exciting new USB accelerator from Google 
transforms the Raspberry Pi’s Al capabilities 
by adding a dedicated neural network 


processor. Also, don't miss Google's AIY site. 


coral.withgoogle.com 


OPENCV 
The tool of choice for many robot builders, 
the Open Source Computer Vision Library 


not only gives your Pi sight, but the ability to 4 
‘comprehend’ what it sees. A powerful tool 

for intelligent object recognition. 

opencv.org 


TENSORFLOW 

If you want implement machine learning on 
a Pi, chances are you'll be using TensorFlow 
to do it. The official site not only features full 
documentation, but also a range of courses. 
tensorflow.org 
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even get to coding. Google has 
provided a self-guided suite 
that starts with a ‘Crash Course’ 
in machine learning, then 
expands to cover the basics 

of problem framing and data 
gathering. The main online 
course comprises 25 lessons 
over 15 hours (approximately, 
you can set your own pace) and 
comes in the form of reading 
materials, interactive sections, 
programming exercises, 

and video tutorials. This is 
then backed by a substantial 
collection of follow-on courses. 
A superb resource. HH 


Jose 
Portilla 


Price: 
£195 (often discounted) 


magpi.cc/rbAdNE 


tu Udemy 
1 


Complete Guide to TensorFlow 
for Deep Learning with Python 


TensorFlow is, without a 
doubt, the most popular 
software library for machine 
learning on the Raspberry Pi. 
If you’re keen to get started 
and write code, TensorFlow will 


Complete Guide to TensorFlow for Deep 


Learning with Python 
L t o use Go ep Learning 


F 
u 


What you'll learn 


Donald 
J Morris 


Price: 
£20 (digital £16) 


magpi.cc/VfrZbO 


Beginning Artificial 
Intelligence with 
the Raspberry P1 


This book is perfectly 
tailored to the Raspberry Pi 
community. Not only does it 
cover the principles behind 
concepts such as neural 
networks, fuzzy logic, and 
shallow versus deep learning, 
it also provides practical, fun 
projects to code and build. 
Starting with simple examples 
of learning, you can play your 
Pi at noughts-and-crosses 
and Nim. Along the way, the 
projects are made fun through 
the use of the Pi’s GPIO header, 
using LEDs and switches to 
bring code to life. You then 
progress to robotics, covering 
obstacle avoidance and light 


probably be your tool of choice. 
You can get a great introduction 
to TensorFlow in The MagPi #71 
(free download: magpi.cc/71), 
but if you are after a deep dive, 
Udemy offers a comprehensive 
14-hour video course that 
covers not only the theory of 
machine learning, but also 

the practicalities of setting up 
the software with real-world 
examples and programming 
exercises. If you’re after a 
hands-on learning approach, 
this may well suit. Don’t be 

put off by the steep price — this 
course is often promoted and 
was £13 at time of writing. 


TECHNOLOGY IN ACTION™ 


wa Donald J. Norris 


seeking. A steady learning curve 
culminates in the building of 
‘Alfie’, your very own artificially 
intelligent robot vehicle. If you 
fancy building the winner of the 
next Pi Wars, this could be the 
perfect reading material. H 
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Learn by 


example 


Do you learn by 
doing? Try these 


HOW TO BUILD DIY Al 
PROJECTS USING GOOGLE 
TENSORFLOW AND 
RASPBERRY Pl 

Acollection of AI/ML projects 
to build or provide inspiration. 
From introductions to 
TensorFlow to a wide range of 
projects including magic mirrors 
and an impressive cucumber 
sorting machine! 
magpi.cc/gLsMHK 


Al ON RASPBERRY PI 
WITH THE INTEL NEURAL 
COMPUTE STICK 

Like Google, Intel has also 
released a USB-based neural 
co-processor. This tutorial is a 
great ‘getting started’ guide, 
talking you through 
installation and on to your first 
facial recognition app. 
magpi.cc/jSShvE 


RASPBERRY PI POKEDEX 
PylmageSearch is an 
incredible resource for 
learning OpenCV. This detailed 
tutorial is ideal for younger 
minds, using a Pi and the 
official touchscreen to create 
a Pokédex that can ‘recognise’ 


plush Pokemon. 


magpi.cc/Ergqjd 
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INTERVIEW 


V Computer vision on the Pi 
is remarkably powerful - 
here's Nicole showing off 
its face detection 
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Nicole 
Parrot 


Home-schooling her kids led Nicole to help others learn to code 


> Category Educator | 


s part of the wider 
educational mission 

of the Raspberry Pi 
Foundation, there’s been an 
ongoing effort to address the 
low percentage of girls and 
women in computing and 
related spaces. While the overall 
gender balance is disappointing, 
there are still some amazing 
women who have always been 
part of the community, such as 
Nicole Parrot. 


> Dayjob CTO | 


“Last millennium I was 
a software developer in the 
special effects industry,” Nicole, 
who currently works at Dexter 
Industries, tells us. “Followed 
by five years at Microsoft in 
3D graphics.” 

Nicole quit in the late nineties 
to home-school her kids, which 
included teaching them and 
other children how to code. 

Her home coding lessons soon 
moved over to schools, and she’s 
helped teachers bring code to 
the classroom. 

“That gives me approximately 
15 years of experience in exposing 
kids to code,” Nicole says. Her 
work at Dexter Industries reflects 
this experience. 


> Website nicole.parrot.ca 


What is your role at 

Dexter Industries? 

Iam CTO for Dexter Industries. 
As such, I manage a small team 
to bring new products to market, 
and create projects. I also manage 
curriculum writing. We want to 
offer teachers the full experience, 
from a Stable robot in the 
classroom to prepared lessons, to 
open-ended projects. Our main 
product is the GoPiGo, now in its 
third iteration. We’ve learned a 
lot about what’s needed to make 
a robot for the classroom, and 
this particular robot is the end 
result. It comes packaged with 
DexterOS, based on Raspbian 
with tools that make it usable out 
of the box. [...] Within DexterOS 
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A This fake snowman is powered by Pi, and manages to survive the cold Québécois winters 


we have Bloxter, a block-based 
language, and Python available, 
again all within the browser. 
I’m quite proud of this project, 
to be honest. 


What inspires you: 
Kids! And this is from a person 
who used to be entirely career- 
oriented. | used to avoid kids, and 
flee from the room if someone 
would bring their kid with them. 
Then I did a full 360 degrees 
when I got my own. Kids are 
such a gift; their way of thinking 
is magical. Their reactions are 
just awesome when they figure 
out something like a tricky 
piece of code, or lighting up an 
LED for the first time. Sharing 
knowledge (remember that I 
home-schooled, I did all subjects, 
all years, and then some more!) 
is the most inspiring experience | 
can think of. 

I’m also a yarn artist, I love 
natural yarns, and I try to 
buy from local breeders when 
possible. I love to know that this 
particular yarn came from an 


M Within DexterOS we have Bloxter, a 
bDlock-based language, and Python 
available, all within the browser @ 


animal with aname, and! get 

to know that name too. I have 

a source for alpaca yarn that 
allows me to visit the animals in 
question. That way I know they 
are well-treated. 


How did you learn about the 
Raspberry Pi: 

I was an early adopter of the Pi. 
I got my first one at Christmas 
2012. I could not get one before 
that because they were not for 
sale in Canada where I reside 

— the first available ones were 
in December. I’ve been around 
since the beginning. However, 

I had been out of tech for a long 
time already by that point, didn’t 
remember any electronics, my 
UNIX was entirely forgotten 
except for ‘vi’. I could use vi and 
even exit it if | wasn’t thinking 
about it. Muscle memory isa 
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4 Nicole's activities don't just 
limit her to Canada - she's 
also been to Cambridge 
(UK) for Pi Wars, and been 
to the Pi Store 


Amazing 
projects 


Nicole has built some 
impressive things with 
Raspberry Pi - here 

are just a few of them: 


GroveP1 Zero 
bike trips 
magpi.cc/MePSpa 


Based on a GPS 
tracker and time- 
lapse photo creator 
that Nicole created 
for long road trips ina 
camper van, you can 
use Google Maps to 
see your trip. 


Holiday wreath 
magpi.cc/DcmEKu 


A Pi-powered wreath 
to put on your door 
during Christmas! 


Dancing 
snowman 
magpi.cc/RPFDkp 


This snowman dances 
to music created by 
Sonic Pi. 


A Nicole teaching data analysis with 
Python for beginners 


funny thing. But there wasn’t 
much I could do with the Pi at 
that point. 

I spent quite a few years 
playing catch-up, getting my 
tech groove back. It was funny 
how simple things were tricky 
to get back — I remember having 
trouble getting two embedded 
loops to work — but more 
advanced concepts like recursion 
were a breeze. Hl 
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This Month 
in Raspberry P1 


Coolest Projects 
International 201 


Kids from around the world show off their incredible projects in Dublin! 


e love seeing photos from any Coolest 
Projects event. The makers, coders, 

and STEAM superstars of tomorrow are 
always at these technology fairs, showing off some 
amazing builds. Coolest Projects International is 
the original and largest of the events, and this year 
was no exception. H] 


01. The venue was huge, and full of 
amazing young makers 


02. Representatives from all the 
countries participating got to 
show their projects 


03. It was even a chance to meet 
some amazing YouTubers 


04. Making in allits forms was 
present at the event 


05. Giant Rock-'em-sock-'em robots 
kept everyone entertained! 


06. Smaller robots also made quite 
a splash at the event 


07. Ever wanted a giant Lego robot 
hand? We do now 


08. Cosplay is definitely making 
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MagPi 


RAAB AES 
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MagP1 


Replying to @TheMagPi 


Amazing projects direct from our Twitter 


Singing rabbit with a pizero, speakerPhat and 
controlled via home assistant 


very Monday we ask the question: have 

you made something with a Pi over the 

weekend? Every Monday, our followers send 
us amazing photos and videos of the things they’ve 
made. Here is a small fraction of them. Follow 
along at #MagPiMonday. 


Brian Corteil © 
@CannonFodder 
Replying to 


Leo White 
@LeoWhitesTweets 


Replying to @TheMagPi 

| built a PS3 controller to Atari DB9 joystick 
adaptor out of a RPi Zero and a couple of 
logic level converters so | can play games on 


my Commodore 64. 
a | 


My teenage son Bill aka @jecifodcer made 
this for his mum's birthday, lit by @pimoroni 
rainbow phat and Pi Zero. 


eo Charly Kihnast 
01. \W/e love the @CharlyKuehnast 
craftsmanship behind Replying to @TheMagPi 


this wonderful gift There's a lux sensor above the Pi's display. As 
’ light decreases, the Pi gradually fires up the 

RGN Solan lights (Philips Hue and IKEA Tradfri) across the 
hope it equnde ane living room. The display and two tiny OLEDs 
and not creepy show the sensor's readings and light status. 


8BitsandaByte 
@8BitsandaByte 


Replying to @TheMagPi 


An internet controlled and tracked hamster 
wheel! &2 


cae y 


03. Now this is avery cool #RaspberryPi #lego 
technical project — it's 
a work in progress, but 
we love the idea 


04. The presentation of 
this project alone is 
enough to warrant a 
spot here 


05. Hamsters and the 
internet are always a 
great combination 
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Universal PRO Nixie 
Tester and Healer 


From the makers of the Nixie HAT, which lets you attach 
a Nixie tube to the top of your Raspberry Pi, comes the 
tester and healer. Nixie tubes may experience problems, 
which are just a natural part of how they work, and this 


~ fe Tee 
device will test and heal many common issues they have. —! 


s = 


igg.me/at/pro-nixietester 


Raspberry Pi Cameras & 
Temperature Sensors: An 
IoT Guide 


Not all projects are physical items —- this one is a book which has wise 
words on environmental sensors and the Raspberry Pi Camera Module 
in relation to lol. The campaign will be finished by the time you read 
this, but it’s already successful so give it a look! 


kck.st/2IPhQ7P 


Best of the rest! 


Here are some other great 
things we saw this month 


Rit 
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EVERGREEN WARNING ETD EL AOL LL. 
From USD$49.99 Only 


“Accidentally fried my Pi, so | turned it into a 
reminder not to do it again...". Extremely wise 
words from Reddit user ironically_maiden. 


Most convenient DAC for Pi 
No compromise in Audio Quality 


192kHz Sampling Rate / 24bit Resolution DAC 
RASPBERRY PI STORE VR 2 Xx Precise Crystal as master clock for lower jitter 
Ultra low noise voltage regulator 
Up to 1.5” OLED Colour Display 


> magpi.cc/uFxUrF 


If you don't live in Cambridge, you may 
never have been to the Raspberry Pi 
Store. Fear not - if you have Google 
Cardboard VR Goggles, you can now look 
around it with this amazing recreation. 


> magpi.cc/EKfGcV 


Power switch with graceful shutdown 
Full integration with Volumio 

Open source software on github 
Optional Case, Amp, CD Upsampling 
& Extraction Add-ons 


http-//nanomesher.com/nanosound 
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Raspberry J 
Event Calendar — 


Find out what community-organised Raspberry Pi-themed 


events are happening near you... 


01. Beijing Raspberry Jam 


™ Monday 3 June 

§ South Side, No. 9 An Hua Street, Beijing, China 

> magpi.cc/bTFQeK 

Anyone who wants to program, or just to get familiar with 
the Raspberry Pi, can join. 


02. Bake-n-Make your own Raspberry Pi 
® Tuesday 4 June 

9 Seattle Makers, Seattle, WA, USA 

> magpi.cc/cmzdwG 

Come gather with other Pi enthusiasts. Any level of 
experience Is welcome. 


03. The All London Raspberry Pi Jam 

® Saturday 8 June 

@ The Microsoft Reactor London, London, UK 
> magpi.cc/NKrVfe 

Aimed at teaching children and parents about 
technology and programming. 


04. Bridport Raspberry Jam 

® Saturday 15 June 

Y Bridport Library, Bridport, UK 

> magpi.cc/FehSPV 

Bridport Jam Is back after a hiatus, with some cool 
demos and robots to show off. 
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05. Bognor Regis Raspberry Jam 


® Saturday 15 June 

9 University of Chichester, Bognor Regis, UK 

> magpi.cc/veSiyh 

An ideal event if you have a Pi and aren't sure what to do 
with it, or you are seeking inspiration for new ideas. 


06. Seattle Raspberry Jam 

= Wednesday 19 June 

© Bellevue Library, Bellevue, WA, USA 

> magpi.cc/NvsBzz 

Participate in the monthly project, share your 
knowledge, or show a project you've created. 


FULL CALENDAR 


Get a full list of upcoming 
events for June and 
beyond here: 


07. Cornwall Tech Jam 
® Saturday 8 June 
© Penwith College, Penzance, UK 


> cornwalltechjam.uk 
For anyone interested in technology, of all ages and 


rpf.io/jam 


abilities. Ask questions and learn about programming. 


08. Stafford Raspberry Jam 

™ Tuesday 11 June 

9 Stafford Library, Stafford, UK 

> magpi.cc/ioiLdO 

Welcoming anyone that wants to show off their projects, 
or see other people's builds! 


EVENTS | Magi [a 


@ & FIND OUT 
eax oe ABOUT JAMS 


% Want a Raspberry Jam 
x ? 
fe gh , in your area: 
% , & Want to start one? 
Email Ben Nuttall about it: 


ao | & jam@raspberrypi.org 
e =% %, S. 


We've highlighted some of the areas S 
in need of ag Jam! Can you help out? 


Raspberry Jam advice: 


Finding a venue 


4d got one of the first Raspberry Pis and was 
looking to find other people like me who 
had little experience of programming a 


and Linux to help and support each other. | wae; : 
approached the library to see if they would : f | 7d: '%, 


] ”) : fa r= 
give us the space and they agreed. ? fe / ~, fe & 
i * - ‘ee = fa ‘_ 
z a i " ~ ig od e 
Simon Belshaw — Exeter Raspberry Jam e © 3 
| Se 
- 
a*® 


“e RASPBERRY SP 


Every Raspberry Jam is entitled to apply fora 
Jam starter kit, which includes magazine issues, 


printed worksheets, stickers, flyers, and more. 
Get the book here: magpi.cc/2q9DHfQ 
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You 
Letters 


> Facebook magpi.cc/facebook 
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Ms Magri | YOUR LETTERS 


International stamps 


I love the Raspberry Pi stamps 
you have! I wish I could get 
them in the USA — is there any 
chance you’ll be releasing them 
over here? 


Jeffrey vid Twitter 


The stamps are not actually made 
by us or Raspberry Pi, they’re 
made by the Royal Mail, so it’s 
not something we can really 

sell you in America. The USPS 
probably wouldn’t accept them. 
You can buy a presentation pack 
from the Royal Mail store in 

the UK (shop.royalmail.com) 
and have them sent to the USA 
(delivery is £2.15 via Royal Mail). 
You can read more about why the 
stamps exist in our story about 
them on page 6. 


Contact us! 


@TheMagPi 


magpi@raspberrypi.org 
raspberrypi.org/forums 


Pj Zero serial interfaces 


I am using a Raspberry Pi Zero 
for my project. Currently Iam 
facing a problem as I need to 
use both a Raspberry Pi Camera 
Module and a Raspberry 

Pi 7-inch touch display. 
Unfortunately, the Pi Zero only 
includes one CSI connector port 
and I don’t want to connect 
that display with HDMI. Is 
there any way to map the HDMI 
to GPIO pins? 


Akhil via email 


This is a bit of a tricky one - we 
do know of a few Raspberry 


VW The HyperPixel works via 
GPIO pins, and may be 
a good alternative 
for some Pi Zero 
projects 


Pi displays that work via the 
GPIO pins. Pimoroni and 
Adafruit have made a few (see 
the HyperPixel for an example: 
magpi.cc/WgSmAA); however 
we’re unable to find specific 
instructions on how to do this 
for the official display. 

All we can suggest is to look for 
a different 7-inch display, or even 
switch it out for the HyperPixel 
4.0, as it is a very nice screen. 


we: 
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Event photos 


I like seeing photos from the Coolest 
Projects and other events — assume 
there’s always more than what we 
see in the magazine, though. Is there 
any way we can get to see all the 
photos from these events? 


Margaret vid Facebook 


Keep an eye on the websites and blogs 
related to these specific events and 
you may see many more photos than 
those we fit in the magazine. We 

have been trying to get a public photo 
repository going, but it’s not as easy as 
uploading an album to Facebook. 

This issue, we have some photos 
that came from Coolest Projects 
International, which you’ll be able 
to find more of on the CoderDojo 
website (coderdojo.com). 
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Article repo 


I needed a contents list for 

the issues of your excellent 
magazine to keep track of 
articles and where to find 
them. So I have created an 
Excel spreadsheet from the 
contents pages of each issue, 
which I have converted to a PDF 
file. Would this be of interest to 
the wider readership? 

Here is a link to the folder on 
Dropbox which contains the 
contents list and status PDFs: 
magpi.cc/SPLiNH. 


Delaware Vid emall 


We do get people asking us 
about contents lists like this 
every now and then, so this 
should be very useful to a lot of 


DAC+ ADC 


Play back yOUr MUSIC. 


Ana record It. 


CE KIT 


Aug-17] 60 | 94 [GETTING THE AlY PROJECTS VOK 
Checking for ory ful 


Sep-17] 61 | 12 [Better Oil drilling with the Pi 
a in Processor 


Pi ZERO W 
Don’t BOOT TO DESKTOPIAD! 


‘Sep-17] 61 | 46 |WINE TEMPERATURE MONITOR 
Sep-17] 61 | 48 [BUILD A 30 PRINTER WITH Pi 


people! We are testing out an 
open-source list for GitHub; it 
might make it easier to update 
by the community. 

We will admit, though, we 
sometimes need to go through 
old issues and find that the odd 
article is not always listed in the 
contents, so don’t always treat 
them as complete. 


Up to 192kHZ/24bit 

Connect existing audio 
equioment and stream 
music over the network 


Create a Karaoke box 


Use the Rasoberry Pi as 
an effects orocessor 


Record audio 


Create a web radio station 


www.hifiberry.com 


HackSpace 
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AYB UKE One of ten 
JAM HATs 


We reviewed the JAM HAT in 
the last issue (magpi.cc/81) 


we 
-A\ 
N - 


and thought It was a really 
“neat solution to adding 
buttons, LEDs, and a buzzer 
to a Raspberry Pi.” Weve 
now got a few to give away. 


M The JAM HAT Is the perfect 
qddd-on board for taking your 
first steps with the Raspberry Pi 

GPIO pins. Designed for beginners 


In association with 


Van 


with GPIO Zero code and examples @ 
‘ane MODMYPI 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/jMxZCU 


Terms & Conditions 


Competition opens on 29 May 2019 and closes on 28 June 2019. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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ALL FORMATS 


Wireframe 
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ALL FORMATS 


Recompile Save data 


Agame-changing The state of modern 
game preservation IN VIDE@eGAMES 


3D Metroidvania 
PIXEL PERFECT 


MODERN GAMES MADE WITH 
RETRO CONSTRAINTS 
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Finding humanity and 
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It's all about community 


Being important is nice, but being nice is important. By Alex Bate 


s Social Media Manager for 
A Raspberry Pi, I always try 

to encourage the members 
of our wonderful community to 
publish their makes online: write 
blog posts, create online tutorials, 
publish videos. We don’t mind what 
you do, so long as we get to share in 
the excitement of those people using 
our product, and see what incredible 
creations you’ re all building. 

But when we ask others to share 
their creativity publicly, we’re also 
asking them to expose a greater part 
of themselves to the wider online 


you share with us, we appreciate it. 
And while I may not dedicate a blog 
post to your build, I can assure you 
that I’ve discussed it aloud, or shared 
it with the team via Slack or email. 


Stay positive 

Recently, while interviewing an 
influencer for my podcast, How 
Does Social (howdoessocial.com), 
about her experiences as a YouTuber, 
I became even more aware of the 
way in which so many creatives 

are exposed to negativity online. 
And while we can continue to tell 


M Ensure that the small bubble of the internet 
In which you exist is g positive one @ 


world, and, sadly, to the negativity 
that can often exist across social 
media platforms, such as Twitter, 
YouTube, and Reddit. 


Ive always strived to help create an 


online safe space for our community. 
While some may feel the need to post 
negativity and spread anger, I’ve 
always aimed to ensure that the our 
small chunk of the internet continues 
to be a safe, welcoming environment 
for those who wish to join in with 

the conversation, and expand their 
Raspberry Pi knowledge. Whatever 
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ourselves that the motivation of 
online trolls is often due to jealousy 
and misinformation, this doesn’t 
lessen the blow when someone 
posts harsh comments about a 
project you’ve dedicated your blood, 
Sweat, and tears to — a project you’re 
infinitely proud of. 

And what I want to Say is this: 
please don’t be put off. For every 
troll, every negative comment, 
there are a hundred people in awe of 
what you’ve done. And every time 
you share your excitement at your 


latest creation, we’re there in the 
background, cheering you on. 


A little respect 
Remember to always protect your 
mental health when it comes to 
existing in the online world, and 
to treat others how you wish to be 
treated. Take five minutes between 
writing a tweet and sending it, to 
ensure you’re happy with it. Post 
positive comments on YouTube, 
share the good points of your day, 
save customer service complaints for 
email and webforms, and ask a friend 
to read the comment section for you 
if it gets too much. Ensure that the 
small bubble of the internet in which 
you exist is a positive one, and that 
the message you share online is one 
of respect and peace. Never feed 
the trolls. Ignoring negativity is the 
best way to ensure it doesn’t grow — 
because who continues talking when 
it’s obvious that no one is listening? 
Peace and love to you all. Your 
friendly neighbourhood internet 
caretaker, Alex. Hl 


Alex Bate 


Social Media Manager for Raspberry Pi. 
Podcaster and maker. 


@alexjrassic 
howdoessocial.com 


THE Official 
RASPBERRY PI 
EGINNERS BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adapters 

8GB microSD card 

116-page beginner’s book 
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Build your own credit card 
sized computer 


Get started with programming 
Set up a Media Center 


Make simple electronic circuits 


Raspberry Pi board and Case 
Power supply and HDMI Cable 
Pre-Programmed Memory Card 
Over 40 electronic Parts 
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DUMM. A Wiley Brand 
Available in Europe 


Available for worldwide shipping at: through RS Components 
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